Get Job

GET

/v1/jobs/:job_id

Get the status of a job.

job_idstringRequired

Successful Response

created_by_idstringOptional

The id of the user that made this object.

last_updated_by_idstringOptional

The id of the user that made this object.

created_atdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The timestamp when the object was created.

updated_atdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The timestamp when the object was last updated.

statusenumOptional

Allowed values: createdrunningcompletedfailedpending

The status of the job.

completed_atdatetimeOptionalDefaults to 1970-01-01T00:00:00.000Z

The unix timestamp of when the job was completed.

metadata_map from strings to anyOptional

The metadata of the job.

idstringOptionalformat: "^job-[a-fA-F0-9]{8}"

The human-friendly ID of the Job

user_idstringOptional

The unique identifier of the user associated with the job.

1	{
2	"created_by_id": "created_by_id",
3	"last_updated_by_id": "last_updated_by_id",
4	"created_at": "2024-01-15T09:30:00Z",
5	"updated_at": "2024-01-15T09:30:00Z",
6	"status": "created",
7	"completed_at": "2024-01-15T09:30:00Z",
8	"metadata_": {
9	"key": "value"
10	},
11	"id": "job-123e4567-e89b-12d3-a456-426614174000",
12	"user_id": "user_id"
13	}

1	curl https://app.letta.com/v1/jobs/job_id \
2	-H "Authorization: Bearer <token>"