Update a time range annotation
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| datasetId | path | string | 是 | OpenAPI 中未发布 |
| annotationId | path | string | 是 | OpenAPI 中未发布 |
| If-Match | header | string | 否 | Optional precondition. A matching tag proceeds and returns the new ETag. A stale tag returns 412 PRECONDITION_FAILED with no write. Absent proceeds (opt-in this release). If-Match: * succeeds when the resource exists. Malformed values return 400 IF_MATCH_INVALID. |
{
"type": "object",
"properties": {
"datasetVersionId": {
"type": "string",
"nullable": true,
"format": "uuid"
},
"annotationSchemaId": {
"type": "string",
"nullable": true,
"format": "uuid"
},
"segmentKind": {
"type": "string",
"enum": [
"action",
"segment",
"event",
"phase",
"quality-issue",
"task",
"subtask",
"skill"
]
},
"startSec": {
"type": "number",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"startNsec": {
"type": "number",
"minimum": 0,
"maximum": 999999999
},
"endSec": {
"type": "number",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"endNsec": {
"type": "number",
"minimum": 0,
"maximum": 999999999
},
"timeReference": {
"type": "string"
},
"title": {
"type": "string",
"nullable": true
},
"naturalLanguageInstruction": {
"type": "string",
"nullable": true
},
"success": {
"type": "boolean",
"nullable": true
},
"score": {
"type": "number",
"nullable": true
},
"failureReason": {
"type": "string",
"nullable": true
},
"parentId": {
"type": "string",
"nullable": true,
"format": "uuid"
},
"orderIndex": {
"type": "number"
},
"reviewStatus": {
"type": "string"
},
"status": {
"type": "string"
},
"attributesJson": {
"type": "object",
"additionalProperties": true,
"nullable": true
}
}
}| 状态码 | 说明 | Content-Type | Schema |
|---|---|---|---|
| 200 | Success | application/json | object |
| 400 | Bad request. Enumerated catalog codes for this operation. | application/problem+json | union |
| 401 | Authentication failed. A specific TOKEN_* cause is returned only when the presented hash matched a stored row. | application/problem+json | union |
| 403 | Authorization failed. PERMISSION_DENIED on an any-of route lists the alternatives in message. | application/problem+json | union |
| 404 | Not found. Enumerated catalog codes for this operation. | application/problem+json | union |
| 409 | Conflict. Enumerated catalog codes for this operation. | application/problem+json | union |
| 412 | If-Match did not match the current resource. No partial write. | application/problem+json | union |
| 429 | Authenticated per-principal or per-tenant request budget exceeded. Rate-limit headers appear only on 429. | application/problem+json | union |
{
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DatasetTimeRangeAnnotationDto"
}
},
"required": [
"data"
]
}{
"allOf": [
{
"$ref": "#/components/schemas/ProblemJson"
},
{
"type": "object",
"properties": {
"status": {
"type": "integer",
"enum": [
400
]
},
"code": {
"type": "string",
"enum": [
"BAD_REQUEST",
"DATASET_VERSION_MISMATCH",
"DATASET_VERSION_NOT_SOFT_HIDDEN",
"EGO_HUMAN_HIGH_RES_COST",
"EGO_HUMAN_PRIVACY_PREREQUISITE",
"EMPTY_UPLOAD_MANIFEST",
"FROZEN_VERSION_ANNOTATION_WRITE_FORBIDDEN",
"GROUPED_DATASET_SCALE",
"IDEMPOTENCY_KEY_INVALID",
"IF_MATCH_INVALID",
"LEGAL_HOLD_SCOPE_INVALID",
"RETENTION_WINDOW_NOT_ELAPSED",
"SNAPSHOT_ROW_IMMUTABLE",
"TENANT_CONTEXT_MISMATCH",
"TENANT_NOT_OFFBOARDING",
"TENANT_REQUIRED",
"UNCLASSIFIED_FILES",
"UNSUPPORTED_FILE_EXTENSION",
"UPLOAD_PLAN_PROJECT_TYPE_UNSUPPORTED",
"UPLOAD_SESSION_EXPIRED",
"VALIDATION_ERROR"
]
}
}
}
]
}{
"allOf": [
{
"$ref": "#/components/schemas/PublishedAuthProblem"
},
{
"type": "object",
"properties": {
"status": {
"type": "integer",
"enum": [
401
]
},
"code": {
"type": "string",
"enum": [
"TOKEN_MALFORMED",
"TOKEN_NOT_FOUND",
"TOKEN_EXPIRED",
"TOKEN_REVOKED",
"UNAUTHORIZED",
"SESSION_EXPIRED",
"ACTIVATION_REQUIRED",
"MFA_REQUIRED"
]
}
}
}
]
}{
"allOf": [
{
"$ref": "#/components/schemas/PublishedAuthProblem"
},
{
"type": "object",
"properties": {
"status": {
"type": "integer",
"enum": [
403
]
},
"code": {
"type": "string",
"enum": [
"PERMISSION_DENIED",
"PERMISSION_NOT_DECLARED",
"FORBIDDEN",
"MEMBERSHIP_NOT_FOUND",
"MEMBERSHIP_DISABLED",
"MEMBERSHIP_EXPIRED",
"PROJECT_MEMBERSHIP_EXPIRED"
]
}
}
}
]
}{
"allOf": [
{
"$ref": "#/components/schemas/ProblemJson"
},
{
"type": "object",
"properties": {
"status": {
"type": "integer",
"enum": [
404
]
},
"code": {
"type": "string",
"enum": [
"ANNOTATION_SNAPSHOT_NOT_FOUND",
"BASE_SNAPSHOT_NOT_FOUND",
"DATASET_NOT_FOUND",
"DATASET_VERSION_FILE_NOT_FOUND",
"DATASET_VERSION_NOT_FOUND",
"FRAME_SPATIAL_ANNOTATION_NOT_FOUND",
"LEGAL_HOLD_NOT_FOUND",
"LEGAL_HOLD_SCOPE_NOT_FOUND",
"LEROBOT_META_INFO_MISSING",
"NOT_FOUND",
"OFFBOARDING_REQUEST_NOT_FOUND",
"SUBJECT_NOT_IN_TENANT",
"TENANT_DELETION_JOB_NOT_FOUND",
"TIME_RANGE_ANNOTATION_NOT_FOUND",
"UPLOAD_BATCH_NOT_FOUND",
"UPLOAD_SESSION_NOT_FOUND",
"USER_NOTIFICATION_NOT_FOUND"
]
}
}
}
]
}{
"allOf": [
{
"$ref": "#/components/schemas/ProblemJson"
},
{
"type": "object",
"properties": {
"status": {
"type": "integer",
"enum": [
409
]
},
"code": {
"type": "string",
"enum": [
"DELETION_BLOCKED_BY_ACTIVE_WORK",
"IDEMPOTENCY_CONFLICT",
"LEGAL_HOLD_ACTIVE",
"LEGAL_HOLD_ALREADY_RELEASED",
"OFFBOARDING_BLOCKED_BY_LEGAL_HOLD",
"OFFBOARDING_BLOCKED_BY_LINEAGE",
"OFFBOARDING_REQUEST_ALREADY_ACTIVE",
"SLUG_ALREADY_EXISTS",
"TENANT_DELETION_JOB_CONFLICT",
"TENANT_DELETION_JOB_NOT_RETRYABLE",
"UPLOAD_BATCH_ACTIVE",
"UPLOAD_BATCH_NOT_DISCARDABLE",
"UPLOAD_SESSION_ALREADY_ABORTED",
"UPLOAD_SESSION_ALREADY_COMPLETED"
]
}
}
}
]
}{
"allOf": [
{
"$ref": "#/components/schemas/ProblemJson"
},
{
"type": "object",
"properties": {
"status": {
"type": "integer",
"enum": [
412
]
},
"code": {
"type": "string",
"enum": [
"PRECONDITION_FAILED"
]
}
}
}
]
}{
"allOf": [
{
"$ref": "#/components/schemas/PublishedAuthProblem"
},
{
"type": "object",
"properties": {
"status": {
"type": "integer",
"enum": [
429
]
},
"code": {
"type": "string",
"enum": [
"RATE_LIMITED"
]
}
}
}
]
}curl -X PATCH 'https://api.embodiflow.io/v1/datasets/{datasetId}/time-range-annotations/{annotationId}' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{}'