Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Get Generation Job

GET/api/v2/notepad/templates/{templateRid}/generationJobs/{generationJobRid}
Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Load an existing GenerationJob. This is used to monitor job progress.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:notepad-write.

Path parameters

templateRid
string

The unique identifier for a Template

generationJobRid
string

The unique identifier for a GenerationJob

Query parameters

preview
boolean
optional

Enables the use of preview functionality.

Response body

GenerationJob
object
Hide child attributes

Hide child attributes

rid
string

The unique identifier for a GenerationJob

status
union

The status of a GenerationJob

Show child attributes

Show child attributes

Examples

Request

Copied!
1 2 3 curl \ \t-H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/v2/notepad/templates/ri.notepad.main.notepad-template.bef90a51-d37d-4983-abde-56e5bd0fcf52/generationJobs/ri.notepad.main.generation-job.ab12c039-353c-4555-9704-eacfdfaa2c1c?preview=true"

Response

Copied!
1 2 3 4 5 6 { "rid": "ri.notepad.main.generation-job.ab12c039-353c-4555-9704-eacfdfaa2c1c", "status": { "type": "running" } }

Error responses

Error Name
GenerationJobNotFoundError CodeNOT_FOUND
Status Code404
DescriptionThe given GenerationJob could not be found.
ParametersgenerationJobRid, templateRid