Profiles
List profile versions
GET
/api/v1alpha1/profiles/{profile_id}/versionsReturns every immutable version of a profile, including archived profiles.
Authorization
apiKey AuthorizationBearer <token>
In: header
Path Parameters
profile_id*string
Identifier of an analysis profile in this workspace.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1alpha1/profiles/prof_0190b5d4-7e1f-7a2b-9c3d-1234567890ab/versions" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "data": [ { "answer_specs": [ { "answer_key": "timeline", "answer_type": "timeline", "evidence": { "accepted_types": [ "clip" ], "per_field": true, "required": true }, "fields": [ { "description": "Observed activity.", "key": "activity", "label": "Activity", "type": "string" } ] } ], "created_at": "2026-08-22T10:00:00.000Z", "created_by": "user_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "instructions": "Inspect the complete video.", "profile_id": "prof_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "version": 1 } ], "has_more": false, "next_cursor": null}Archive an analysis profile DELETE
Archives the profile instead of deleting it. The operation is idempotent and preserves every version.
Create a profile version POST
Appends an immutable version. A profile can have at most 100 versions. Archived and anonymous profiles reject new versions with a conflict.