Articles
Accept a bounded article generation batch
Uses existing article-generation quota for accepted work. Returns HTTP
202 with a receipt whose status is already succeeded: accepting the
batch is the command’s outcome, and the receipt expires with the normal
receipt retention. selection.accepted_ids are the IDs of the articles
being generated; follow each one with getArticle or listArticles.
Replaying the same idempotency key returns the same batch and selection
without consuming quota again.
POST
/
profiles
/
{profile_id}
/
article-generations
Error
A valid request URL is required to generate request examples{
"data": {
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"receipt": {
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "accepted",
"resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"selection": {
"accepted_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"skipped": [
{
"keyword": "<string>",
"reason": "<string>",
"keyword_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}
},
"meta": {
"request_id": "<string>",
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}Authorizations
OAuth2PersonalAPIKey
Headers
Path Parameters
Body
application/json
- Option 1
- Option 2
Supply existing keyword IDs or bounded new keyword/title seeds.
⌘I
Error
A valid request URL is required to generate request examples{
"data": {
"batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"receipt": {
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "accepted",
"resource_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"selection": {
"accepted_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"skipped": [
{
"keyword": "<string>",
"reason": "<string>",
"keyword_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}
},
"meta": {
"request_id": "<string>",
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}
