Workspaces and files¶

39 endpoints. Every path below is served by trilocore-contractide-backend behind the gateway at https://api.trilocore.ai.

GET `/api/v1/ide/workspaces`¶

List Workspaces

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST `/api/v1/ide/workspaces`¶

Create Workspace

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`name`	string	yes	—
`slug`	string	yes	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "…", "slug": "…"}'

▶ Run this example in the sandbox

DELETE `/api/v1/ide/workspaces/{uuid}`¶

Delete Workspace

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

curl

curl -X DELETE https://api.trilocore.ai/api/v1/ide/workspaces/{uuid} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET `/api/v1/ide/workspaces/{uuid}`¶

Get Workspace

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/analyses`¶

List Analyses

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/analyses \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST `/api/v1/ide/workspaces/{uuid}/analyses`¶

Start Analysis

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`analysis_type`	string	yes	—
`ref`	one of	no	—
`settings`	object	no	—
`tool_id`	one of	no	—
`tool_version`	one of	no	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/analyses \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"analysis_type": "…"}'

POST `/api/v1/ide/workspaces/{uuid}/annotations`¶

Create Dev Note

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`body`	string	no	—
`category`	one of	no	—
`commit_oid`	string	yes	—
`end_line`	integer	yes	—
`kind`	string	no	—
`path`	string	yes	—
`severity`	one of	no	—
`start_line`	integer	yes	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/annotations \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"commit_oid": "…", "path": "…", "start_line": 0, "end_line": 0}'

GET `/api/v1/ide/workspaces/{uuid}/audit-log`¶

Get Workspace Audit Log

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/audit-log \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/audits`¶

List Engagements

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/audits \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST `/api/v1/ide/workspaces/{uuid}/audits`¶

Open Engagement

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`pinned_commit_oid`	string	yes	—
`title`	string	yes	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/audits \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "…", "pinned_commit_oid": "…"}'

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/bindings`¶

Get Bindings

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/bindings \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

PUT `/api/v1/ide/workspaces/{uuid}/bindings`¶

Put Binding

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`default_branch`	string	no	—
`external_full_name`	string	yes	—
`external_repository_id`	string	yes	—
`integration_id`	string	yes	—
`sync_mode`	string	yes	—

curl

curl -X PUT https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/bindings \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"integration_id": "…", "external_repository_id": "…", "external_full_name": "…", "sync_mode": "…"}'

POST `/api/v1/ide/workspaces/{uuid}/bindings/push`¶

Push Binding

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`commit_oid`	one of	no	—
`force`	boolean	no	—
`provider`	string	yes	—
`target_ref`	one of	no	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/bindings/push \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"provider": "…"}'

GET `/api/v1/ide/workspaces/{uuid}/branch-protection`¶

List Branch Protection

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/branch-protection \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

PUT `/api/v1/ide/workspaces/{uuid}/branch-protection`¶

Put Branch Protection

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`linear_history`	boolean	no	—
`min_approvals`	integer	no	—
`no_deletion`	boolean	no	—
`no_force_push`	boolean	no	—
`ref_pattern`	string	yes	—
`require_code_owner_review`	boolean	no	—
`require_security_approval`	boolean	no	—
`required_status_checks`	array	no	—

curl

curl -X PUT https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/branch-protection \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ref_pattern": "…"}'

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/branches`¶

List Branches

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/branches \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST `/api/v1/ide/workspaces/{uuid}/branches`¶

Create Branch

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`from_oid`	one of	no	—
`name`	string	yes	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/branches \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'

▶ Run this example in the sandbox

DELETE `/api/v1/ide/workspaces/{uuid}/branches/{id}`¶

Delete Branch

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

curl

curl -X DELETE https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/branches/{id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

PATCH `/api/v1/ide/workspaces/{uuid}/branches/{id}/protection`¶

Set Branch Protection

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`protected`	boolean	yes	—

curl

curl -X PATCH https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/branches/{id}/protection \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"protected": false}'

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/draft`¶

Get Draft

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/draft \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

PUT `/api/v1/ide/workspaces/{uuid}/draft/files/{rest}`¶

Autosave Draft

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

application/octet-stream: the raw content, sent as the body
text/plain: the raw content, sent as the body

The file's autosaved content, as raw bytes (Content-Type is not checked). An absent body saves an empty file. Refused: more than CONTRACTIDE_MAX_FILE_BYTES (default 2 MiB) → 413, the file PUT's cap and refusal; nothing is saved. There is no NUL-byte check on drafts.

curl

curl -X PUT https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/draft/files/{rest} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: text/plain" \
  --data-binary @./Contract.sol

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/files`¶

List Files

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Query parameters

Parameter	Type	Required	Constraints	Description
`ref`	string	no	—	—

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/files \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/files/{rest}`¶

Get File

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Query parameters

Parameter	Type	Required	Constraints	Description
`ref`	string	no	—	—

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/files/{rest} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

PUT `/api/v1/ide/workspaces/{uuid}/files/{rest}`¶

Update File

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

application/octet-stream: the raw content, sent as the body
text/plain: the raw content, sent as the body

The file's complete new content, as raw bytes (Content-Type is not checked). An absent body writes an empty file. Refused: more than CONTRACTIDE_MAX_FILE_BYTES (default 2 MiB) → 413, checked on Content-Length before the body is read; a NUL byte in a known text source (.sol, .vy, .rs, …) → 400.

curl

curl -X PUT https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/files/{rest} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: text/plain" \
  --data-binary @./Contract.sol

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/findings.sarif`¶

Workspace Findings Sarif

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/findings.sarif \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST `/api/v1/ide/workspaces/{uuid}/findings/ingest`¶

Ingest Findings

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`analyzer`	string	no	—
`commit_oid`	string	yes	—
`engagement_id`	one of	no	—
`findings`	array of RawFinding	yes	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/findings/ingest \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"commit_oid": "…", "findings": []}'

DELETE `/api/v1/ide/workspaces/{uuid}/github`¶

Disconnect Github

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

curl

curl -X DELETE https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/github \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET `/api/v1/ide/workspaces/{uuid}/github`¶

Github Status

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/github \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

PUT `/api/v1/ide/workspaces/{uuid}/github`¶

Connect Github

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`branch`	string	no	—
`repo`	string	yes	—
`token`	string	yes	—

curl

curl -X PUT https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/github \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"repo": "…", "token": "…"}'

POST `/api/v1/ide/workspaces/{uuid}/github/publish`¶

Publish To Github

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`force`	boolean	no	—
`ref`	one of	no	—
`remote_branch`	one of	no	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/github/publish \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"force": false, "ref": "…", "remote_branch": "…"}'

GET `/api/v1/ide/workspaces/{uuid}/languages`¶

Workspace Languages

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/languages \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/members`¶

List Members

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/members \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST `/api/v1/ide/workspaces/{uuid}/members`¶

Invite Member

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`engagement_id`	one of	no	—
`expires_at`	one of	no	—
`role`	string	yes	—
`user_id`	string	yes	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/members \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "…", "role": "…"}'

▶ Run this example in the sandbox

DELETE `/api/v1/ide/workspaces/{uuid}/members/{id}`¶

Remove Member

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

curl

curl -X DELETE https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/members/{id} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/merge-requests`¶

List Merge Requests

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/merge-requests \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST `/api/v1/ide/workspaces/{uuid}/merge-requests`¶

Create Merge Request

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`description`	one of	no	—
`source_ref`	string	yes	—
`status`	string	no	—
`target_ref`	string	yes	—
`title`	string	yes	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/merge-requests \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_ref": "…", "target_ref": "…", "title": "…"}'

▶ Run this example in the sandbox

POST `/api/v1/ide/workspaces/{uuid}/scaffold`¶

Scaffold Workspace

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`force`	boolean	no	—
`template`	string	yes	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/scaffold \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template": "…"}'

▶ Run this example in the sandbox

GET `/api/v1/ide/workspaces/{uuid}/tags`¶

List Tags

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`
Pagination	paged: `page_size` ≤ 200 (default 50) + `page_token`; the body is `{data, has_more, next_page_token, page_size}`

Query parameters

Parameter	Type	Required	Constraints	Description
`page_size`	integer	no	default 50, clamped to 200, `minimum` 1	Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as `page_size`.
`page_token`	string	no	`maxLength` 2048	Opaque token from a previous page's `next_page_token`. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page.

curl

curl -X GET https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/tags \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST `/api/v1/ide/workspaces/{uuid}/tags`¶

Create Tag

Property	Value
Authentication	`Authorization: Bearer` (`jns_` key or SSO session)
Idempotency-Key	not required
Success	`200`
Upstream	`trilocore-contractide-backend`

Request body

Field	Type	Required	Constraints
`name`	string	yes	—
`oid`	one of	no	—
`protected`	boolean	no	—

curl

curl -X POST https://api.trilocore.ai/api/v1/ide/workspaces/{uuid}/tags \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'

▶ Run this example in the sandbox

Workspaces and files¶

GET /api/v1/ide/workspaces¶

POST /api/v1/ide/workspaces¶

DELETE /api/v1/ide/workspaces/{uuid}¶

GET /api/v1/ide/workspaces/{uuid}¶

GET /api/v1/ide/workspaces/{uuid}/analyses¶

POST /api/v1/ide/workspaces/{uuid}/analyses¶

POST /api/v1/ide/workspaces/{uuid}/annotations¶

GET /api/v1/ide/workspaces/{uuid}/audit-log¶

GET /api/v1/ide/workspaces/{uuid}/audits¶

POST /api/v1/ide/workspaces/{uuid}/audits¶

GET /api/v1/ide/workspaces/{uuid}/bindings¶

PUT /api/v1/ide/workspaces/{uuid}/bindings¶

POST /api/v1/ide/workspaces/{uuid}/bindings/push¶

GET /api/v1/ide/workspaces/{uuid}/branch-protection¶

PUT /api/v1/ide/workspaces/{uuid}/branch-protection¶

GET /api/v1/ide/workspaces/{uuid}/branches¶

POST /api/v1/ide/workspaces/{uuid}/branches¶

DELETE /api/v1/ide/workspaces/{uuid}/branches/{id}¶

PATCH /api/v1/ide/workspaces/{uuid}/branches/{id}/protection¶

GET /api/v1/ide/workspaces/{uuid}/draft¶

PUT /api/v1/ide/workspaces/{uuid}/draft/files/{rest}¶

GET /api/v1/ide/workspaces/{uuid}/files¶

GET /api/v1/ide/workspaces/{uuid}/files/{rest}¶

PUT /api/v1/ide/workspaces/{uuid}/files/{rest}¶

GET /api/v1/ide/workspaces/{uuid}/findings.sarif¶

POST /api/v1/ide/workspaces/{uuid}/findings/ingest¶

DELETE /api/v1/ide/workspaces/{uuid}/github¶

GET /api/v1/ide/workspaces/{uuid}/github¶

PUT /api/v1/ide/workspaces/{uuid}/github¶

POST /api/v1/ide/workspaces/{uuid}/github/publish¶

GET /api/v1/ide/workspaces/{uuid}/languages¶

GET /api/v1/ide/workspaces/{uuid}/members¶

POST /api/v1/ide/workspaces/{uuid}/members¶

DELETE /api/v1/ide/workspaces/{uuid}/members/{id}¶

GET /api/v1/ide/workspaces/{uuid}/merge-requests¶

POST /api/v1/ide/workspaces/{uuid}/merge-requests¶

POST /api/v1/ide/workspaces/{uuid}/scaffold¶

GET /api/v1/ide/workspaces/{uuid}/tags¶

POST /api/v1/ide/workspaces/{uuid}/tags¶

GET `/api/v1/ide/workspaces`¶

POST `/api/v1/ide/workspaces`¶

DELETE `/api/v1/ide/workspaces/{uuid}`¶

GET `/api/v1/ide/workspaces/{uuid}`¶

GET `/api/v1/ide/workspaces/{uuid}/analyses`¶

POST `/api/v1/ide/workspaces/{uuid}/analyses`¶

POST `/api/v1/ide/workspaces/{uuid}/annotations`¶

GET `/api/v1/ide/workspaces/{uuid}/audit-log`¶

GET `/api/v1/ide/workspaces/{uuid}/audits`¶

POST `/api/v1/ide/workspaces/{uuid}/audits`¶

GET `/api/v1/ide/workspaces/{uuid}/bindings`¶

PUT `/api/v1/ide/workspaces/{uuid}/bindings`¶

POST `/api/v1/ide/workspaces/{uuid}/bindings/push`¶

GET `/api/v1/ide/workspaces/{uuid}/branch-protection`¶

PUT `/api/v1/ide/workspaces/{uuid}/branch-protection`¶

GET `/api/v1/ide/workspaces/{uuid}/branches`¶

POST `/api/v1/ide/workspaces/{uuid}/branches`¶

DELETE `/api/v1/ide/workspaces/{uuid}/branches/{id}`¶

PATCH `/api/v1/ide/workspaces/{uuid}/branches/{id}/protection`¶

GET `/api/v1/ide/workspaces/{uuid}/draft`¶

PUT `/api/v1/ide/workspaces/{uuid}/draft/files/{rest}`¶

GET `/api/v1/ide/workspaces/{uuid}/files`¶

GET `/api/v1/ide/workspaces/{uuid}/files/{rest}`¶

PUT `/api/v1/ide/workspaces/{uuid}/files/{rest}`¶

GET `/api/v1/ide/workspaces/{uuid}/findings.sarif`¶

POST `/api/v1/ide/workspaces/{uuid}/findings/ingest`¶

DELETE `/api/v1/ide/workspaces/{uuid}/github`¶

GET `/api/v1/ide/workspaces/{uuid}/github`¶

PUT `/api/v1/ide/workspaces/{uuid}/github`¶

POST `/api/v1/ide/workspaces/{uuid}/github/publish`¶

GET `/api/v1/ide/workspaces/{uuid}/languages`¶

GET `/api/v1/ide/workspaces/{uuid}/members`¶

POST `/api/v1/ide/workspaces/{uuid}/members`¶

DELETE `/api/v1/ide/workspaces/{uuid}/members/{id}`¶

GET `/api/v1/ide/workspaces/{uuid}/merge-requests`¶

POST `/api/v1/ide/workspaces/{uuid}/merge-requests`¶

POST `/api/v1/ide/workspaces/{uuid}/scaffold`¶

GET `/api/v1/ide/workspaces/{uuid}/tags`¶

POST `/api/v1/ide/workspaces/{uuid}/tags`¶