Account Template API

Update an account template. The request body must include `expectedRevision`; mismatch with the current revision returns HTTP 409.

Changed on Nov 2, 2026

put/rest/api/v1/projects/{projectId}/templates/{templateId}

Request

Base URL
https://api.metacopier.io
Auth
API key in header X-API-KEY
TypeScript
https://skmtc.dev/metacopier/apis/metacopier-api/docs/rest/api/v1/projects/:projectId/templates/:templateId/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

projectIdstring uuid required

templateIdstring uuid required

Request body

attentionReasonstring

Short human-readable explanation of why needsAttention is set.

blocksstring[]

Content blocks this template carries.

compatibilitystring

Payload compatibility marker: CURRENT, AUTO_MIGRATED, or REVIEW_NEEDED.

createdstring date-time

createdBystring

descriptionstring

expectedRevisioninteger

Required on update. The server compares this against the current revision and returns HTTP 409 on mismatch.

idstring uuid

linkedCountinteger

Number of accounts currently linked to this template.

metadataUpdatedstring date-time

namestring required

Display name. Must be unique per project (case-insensitive).

needsAttentionboolean

True if this template references resources that no longer exist (for example, a deleted source account or strategy).

payloadJsonNode required

Full template payload. Includes a schemaVersion discriminator describing its JSON shape; older versions are migrated transparently on read.

projectIdstring uuid

Project this template belongs to. Set from the URL path; any value in the body is ignored.

referenceAccountIdstring uuid

Account that was used as the source when this template was created. Helps clients resolve symbol references in the payload.

revisioninteger

Current revision number. Bumped only when the payload actually changes.

updatedstring date-time

updatedBystring

Response