API7 Docs

List model catalog sync logs

GET /api/model_sync_logs

GET /api/model_sync_logs

Interactive request editor loads with JavaScript.

Authorization

X-API-KEY<token>

In: header

Query Parameters

direction?string

Order to list the resources by. The sorting index follows the configuration of order_by.

Default"desc"

Value in

  • "asc"
  • "desc"
page_size?integer

Number of resources listed per page. Used together with page. For example, when there are 13 resources in total, if the query parameters are page=1&page_size=10, the GET response will show the route total as 13 and display 10 resources in the first page. If the query parameters are page=2&page_size=10, the GET response will show the route total as 13 and display 3 resources in the second page.

Formatint32
Range1 <= value
page?integer

Page number of the listed resources. Used together with page_size. For example, when there are 13 resources in total, if the query parameters are page=1&page_size=10, the GET response will show the route total as 13 and display 10 resources in the first page. If the query parameters are page=2&page_size=10, the GET response will show the route total as 13 and display 3 resources in the second page.

Formatint32
Range1 <= value
order_by?string

Field used to order sync log entries.

Default"started_at"

Value in

  • "started_at"
  • "completed_at"
  • "duration_ms"
  • "http_status"
  • "status"
  • "trigger_type"
  • "created_at"
trigger_type?string

Filter logs by trigger source.

Value in

  • "scheduled"
  • "manual"
status?string

Filter logs by execution status.

Value in

  • "running"
  • "success"
  • "failed"

Response Body

application/json

application/json

curl -X GET "$API_BASE_URL/api/model_sync_logs"

Successfully retrieved the paginated model sync logs.

{
  "total": 1,
  "list": [
    {
      "id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
      "trigger_type": "scheduled",
      "status": "running",
      "endpoint": "https://models.dev/api.json",
      "started_at": 1742288230,
      "completed_at": 1742288230,
      "duration_ms": 431,
      "http_status": 200,
      "error_message": "unexpected HTTP status: 503",
      "diff": [
        {
          "op": "add",
          "path": "/name",
          "value": "new-name"
        }
      ],
      "created_at": 1742288232
    }
  ]
}
Complete operation details and schema variants

GET /api/model_sync_logs

List model catalog sync logs

IAM Action: ai_gateway:ListModelSyncLogs, Resource: arn:api7:ai_gateway:modelcatalog/* Returns synchronization history entries, including execution status and structured diff information.

Parameters

  • direction (query, string, optional): Order to list the resources by. The sorting index follows the configuration of order_by.
  • page_size (query, integer, optional): Number of resources listed per page. Used together with page. For example, when there are 13 resources in total, if the query parameters are page=1&page_size=10, the GET response will show the route total as 13 and display 10 resources in the first page. If the query parameters are page=2&page_size=10, the GET response will show the route total as 13 and display 3 resources in the second page.
  • page (query, integer, optional): Page number of the listed resources. Used together with page_size. For example, when there are 13 resources in total, if the query parameters are page=1&page_size=10, the GET response will show the route total as 13 and display 10 resources in the first page. If the query parameters are page=2&page_size=10, the GET response will show the route total as 13 and display 3 resources in the second page.
  • order_by (query, string, optional): Field used to order sync log entries.
  • trigger_type (query, string, optional): Filter logs by trigger source.
  • status (query, string, optional): Filter logs by execution status.

Responses

  • 200: Successfully retrieved the paginated model sync logs.
  • allOf variant 1
  • list (array, optional): An array of resources.
  • total (integer, optional): Total number of objects.
  • allOf variant 2
  • list (array, optional): An array of model catalog sync log entries.
  • list[].id (string, optional): The object ID.
  • list[].trigger_type (string, optional): Source that triggered the synchronization run.
  • list[].status (string, optional): Final or current execution status of the synchronization run.
  • list[].endpoint (string, optional): Sanitized source endpoint contacted during the synchronization attempt.
  • list[].started_at (integer, optional): The object timestamp.
  • list[].completed_at (object, optional): Completion time of the synchronization attempt. Null while a run is still in progress.
  • anyOf variant 1
  • anyOf variant 2
  • list[].duration_ms (integer,null, optional): Total elapsed time of the synchronization run in milliseconds.
  • list[].http_status (integer,null, optional): HTTP status code returned by the upstream source, when available.
  • list[].error_message (string,null, optional): Error summary when the synchronization failed or was skipped.
  • list[].diff (object, optional): RFC 6902 JSON Patch operations for the synchronization result.
  • anyOf variant 1
  • oneOf variant 1: add/replace
  • list[].diff[].op (string, required): The operation to be performed.
  • list[].diff[].path (string, required): Path to the field to be replaced or added. Path should follow the JSON Pointer format.
  • list[].diff[].value (object, required): Value to be added or replaced.
  • oneOf variant 2: remove
  • list[].diff[].op (string, required): The operation to be performed.
  • list[].diff[].path (string, required): Path to the field to be removed. Path should follow the JSON Pointer format.
  • anyOf variant 2
  • list[].created_at (integer, optional): The object created timestamp.
  • 400: Bad Request — The request was malformed or contained invalid parameters. Check the error_msg field for details.
  • value (object, optional): The specific resource.
  • error_msg (string, optional): The error message.

cURL

curl -X GET '$API_BASE_URL/api/model_sync_logs'