Skip to main content
POST
/
v2
/
workspaces
/
platform
/
versions
Push Platform Versions
curl --request POST \
  --url https://api.studio.prisme.ai/v2/workspaces/platform/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "groups": [
    "<string>"
  ],
  "repository": {
    "id": "<string>"
  },
  "name": "<string>",
  "createdAt": "<string>",
  "description": {
    "fr": "Bonjour",
    "en": "Hello"
  },
  "dryRun": false,
  "force": false
}
'
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    groups: ['<string>'],
    repository: {id: '<string>'},
    name: '<string>',
    createdAt: '<string>',
    description: {fr: 'Bonjour', en: 'Hello'},
    dryRun: false,
    force: false
  })
};

fetch('https://api.studio.prisme.ai/v2/workspaces/platform/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
import requests

url = "https://api.studio.prisme.ai/v2/workspaces/platform/versions"

payload = {
    "groups": ["<string>"],
    "repository": { "id": "<string>" },
    "name": "<string>",
    "createdAt": "<string>",
    "description": {
        "fr": "Bonjour",
        "en": "Hello"
    },
    "dryRun": False,
    "force": False
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
{
  "processing": true,
  "message": "<string>"
}
{
  "error": "BadParameters",
  "message": "<string>",
  "details": "<unknown>"
}
{
  "error": "AuthenticationError",
  "message": "Unauthenticated"
}
{
  "error": "ForbiddenError",
  "message": "Forbidden"
}
{
  "error": "ObjectNotFound",
  "message": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
sse
boolean

If true, streams progress as Server-Sent Events (text/event-stream) instead of returning a single JSON response.

​
timeout
number

HTTP timeout in seconds. If the push exceeds this, the response returns {processing: true} and the result is emitted as a workspaces.bulkExport.completed event.

Body

application/json
​
groups
string[]

Group names to push (must exist in WORKSPACE_GROUPS config)

Minimum array length: 1
​
repository
object
​
name
string

Version name. If left empty, will be auto generated

​
createdAt
string
​
description
Example:
{ "fr": "Bonjour", "en": "Hello" }
​
dryRun
boolean
default:false

When true, only returns workspace categorization without actually pushing any versions.

​
force
boolean
default:false

When true, also pushes workspaces that are already up to date (not dirty), forcing a re-push of all matching workspaces.

Response

Bulk push result or SSE stream

Push still processing (HTTP timeout reached)

​
processing
boolean
​
message
string