copySpaceItem
Copy a FILE into a folder or root you can edit.
Copy a FILE into a folder or root you can edit. The copy is yours and starts with no sharing; copying somewhere with a different audience needs MANAGER on the source unless it was already open to the whole team, and an AI agent can never make that kind of copy. Folders cannot be copied yet.
curl https://server.goliathdata.com/api/v1/call \
-H "Authorization: Bearer $GOLIATH_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"operationId": "copySpaceItem",
"variables": {
"input": {
"itemId": "<itemId>",
"destination": {
"spaceId": "<spaceId>"
}
}
}
}'import { GoliathClient } from '@goliath-data/sdk'
const goliath = new GoliathClient({
apiKey: process.env.GOLIATH_API_KEY!,
baseUrl: 'https://server.goliathdata.com',
})
const result = await goliath.spaces.copySpaceItem(
{
input: {
itemId: '<itemId>',
destination: {
spaceId: '<spaceId>'
}
}
},
{ idempotencyKey: crypto.randomUUID() },
)const res = await fetch('https://server.goliathdata.com/api/v1/call', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GOLIATH_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
operationId: 'copySpaceItem',
variables: {
input: {
itemId: '<itemId>',
destination: {
spaceId: '<spaceId>'
}
}
}
}),
})
const { data, errors } = await res.json()Variables
The example sends only what the schema requires. Some operations also need one of several optional variables (one filter or another, say); the description above says which.
Every field, all the way down
[
{
"name": "input",
"type": "CopySpaceItemInput!",
"required": true,
"description": null,
"defaultValue": null,
"fields": [
{
"name": "itemId",
"type": "ID!",
"required": true,
"description": null,
"defaultValue": null
},
{
"name": "destination",
"type": "SpaceDestinationInput!",
"required": true,
"description": null,
"defaultValue": null,
"fields": [
{
"name": "spaceId",
"type": "ID!",
"required": true,
"description": null,
"defaultValue": null
},
{
"name": "folderId",
"type": "ID",
"required": false,
"description": "Null for the space root.",
"defaultValue": null
}
]
}
]
}
]Response
What comes back under data: a list shows as one entry, and a value as its type.
{
"data": {
"spacesMutation": {
"copy": {
"id": "<ID>",
"spaceId": "<ID>",
"spaceName": "…",
"parentId": "<ID>",
"kind": "FOLDER",
"name": "…",
"description": "…",
"fileType": "…",
"sizeBytes": 0,
"accessMode": "INHERIT",
"systemLocked": true,
"viewerRole": "VIEWER",
"abilities": {
"addChildren": true,
"edit": true,
"move": true,
"trash": true,
"share": true
},
"owner": {
"id": "<ID>",
"name": "…"
},
"createdBy": {
"kind": "PERSON",
"label": "…"
},
"childCount": 0,
"shareCount": 0,
"currentVersion": {
"id": "<ID>",
"versionNumber": 0
},
"path": [
{
"id": "<ID>",
"name": "…"
}
],
"updatedAt": "2026-01-01T00:00:00.000Z",
"trashedAt": "2026-01-01T00:00:00.000Z"
}
}
}
}Errors
unknown_variableA variable the operation does not declare. A typo is refused rather than silently dropped.
unauthorizedNo bearer header, or the key is invalid or revoked.
insufficient_scopeThe key lacks the scope the operation requires.
forbiddenA referenced record does not exist, was deleted, or is outside your organization. The gateway cannot tell those apart.
idempotency_conflictA request with this Idempotency-Key is still in flight.
Idempotency
Send an Idempotency-Key of 1 to 255 characters. A finished request retried with the same key replays its stored response, marked Idempotency-Replayed: true; one still in flight returns 409 idempotency_conflict. Keys expire after 24 hours. Write without fear →