Skip to main content
Cohere

Search documentation

Type to search this documentation.

Fetch history of statuses for a fine-tuned model.

GET/v1/finetuning/finetuned-models/{finetuned_model_id}/eventsFetch history of statuses for a fine-tuned model.

Returns a list of events that occurred during the life-cycle of the fine-tuned model. The events are ordered by creation time, with the most recent event first. The list can be paginated using page_size and page_token parameters.

Parameters

finetuned_model_idstringpathrequired

The parent fine-tuned model ID.

page_sizeinteger · int32query

Maximum number of results to be returned by the server. If 0, defaults to 50.

page_tokenstringquery

Request a specific page of the list results.

order_bystringquery

Comma separated list of fields. For example: "created_at,name". The default sorting order is ascending. To specify descending order for a field, append " desc" to the field name. For example: "created_at desc,name". Supported sorting fields: - created_at (default)

X-Client-Namestringheader

The name of the project that is making the request.

Responses

200A successful response.application/json
objectdeprecatedListEventsResponse

Response to a request to list events of a fine-tuned model.

eventsarray of object

List of events for the fine-tuned model.

Show child attributes
Show array items

A change in status of a fine-tuned model.

created_atstring · date-time

Timestamp when the event happened.

statusstring

The possible stages of a fine-tuned model life-cycle. - STATUS_UNSPECIFIED: Unspecified status. - STATUS_FINETUNING: The fine-tuned model is being fine-tuned. - STATUS_DEPLOYING_API: Deprecated: The fine-tuned model is being deployed. - STATUS_READY: The fine-tuned model is ready to receive requests. - STATUS_FAILED: The fine-tuned model failed. - STATUS_DELETED: The fine-tuned model was deleted. - STATUS_TEMPORARILY_OFFLINE: Deprecated: The fine-tuned model is temporarily unavailable. - STATUS_PAUSED: Deprecated: The fine-tuned model is paused (Vanilla only). - STATUS_QUEUED: The fine-tuned model is queued for training.

one of "STATUS_UNSPECIFIED", "STATUS_FINETUNING", "STATUS_DEPLOYING_API", "STATUS_READY", "STATUS_FAILED", "STATUS_DELETED", "STATUS_TEMPORARILY_OFFLINE", "STATUS_PAUSED", "STATUS_QUEUED" · default "STATUS_UNSPECIFIED"

user_idstring

ID of the user who initiated the event. Empty if initiated by the system.

next_page_tokenstring

Pagination token to retrieve the next page of results. If the value is "", it means no further results for the request.

total_sizeinteger · int32

Total count of results.

Example response
{
  "events": [
    {
      "created_at": "2024-01-17T20:11:45.267960Z",
      "status": "STATUS_QUEUED",
      "user_id": "7a317d97-4d05-427d-9396-f31b9fb92c55"
    },
    {
      "created_at": "2024-01-17T20:11:46.000862Z",
      "status": "STATUS_FINETUNING",
      "user_id": "7a317d97-4d05-427d-9396-f31b9fb92c55"
    },
    {
      "created_at": "2024-01-17T20:31:05.047066Z",
      "status": "STATUS_DEPLOYING_API",
      "user_id": "7a317d97-4d05-427d-9396-f31b9fb92c55"
    },
    {
      "created_at": "2024-01-17T20:31:06.988655Z",
      "status": "STATUS_READY"
    }
  ],
  "total_size": 5
}
400Bad Requestapplication/json
objectdeprecatedError

Error is the response for any unsuccessful event.

messagestring

A developer-facing error message.

Example response
{
  "message": "string"
}
401Unauthorizedapplication/json
objectdeprecatedError

Error is the response for any unsuccessful event.

messagestring

A developer-facing error message.

Example response
{
  "message": "string"
}
403Forbiddenapplication/json
objectdeprecatedError

Error is the response for any unsuccessful event.

messagestring

A developer-facing error message.

Example response
{
  "message": "string"
}
404Not Foundapplication/json
objectdeprecatedError

Error is the response for any unsuccessful event.

messagestring

A developer-facing error message.

Example response
{
  "message": "string"
}
500Internal Server Errorapplication/json
objectdeprecatedError

Error is the response for any unsuccessful event.

messagestring

A developer-facing error message.

Example response
{
  "message": "string"
}
503Status Service Unavailableapplication/json
objectdeprecatedError

Error is the response for any unsuccessful event.

messagestring

A developer-facing error message.

Example response
{
  "message": "string"
}
Documentation menu