Run a transformation

Required capabilities: transformationsAcl:WRITE

Securityoidc-token or oauth2-client-credentials or oauth2-open-industrial-data or oauth2-auth-code
Request
Request Body schema: application/json
required
One of:
externalId
required
string (CogniteExternalId) <= 255 characters

The external ID provided by the client. Must be unique for the resource type.

object (NonceCredentials)

Credentials for a CDF session (sessionId, nonce, and project name). These are obtained when you create a session via the Sessions API. See Sessions API documentation for more information.

Responses
200

Response with a single job.

400

The response for a failed request.

403

The response for a forbidden request.

post/transformations/run
Request samples
application/json
{
  • "externalId": "my.known.id",
  • "nonce": {
    • "sessionId": 0,
    • "nonce": "string",
    • "cdfProjectName": "string",
    • "clientId": "string"
    }
}
Response samples
application/json
{
  • "id": 0,
  • "uuid": "string",
  • "transformationId": 0,
  • "transformationExternalId": "string",
  • "sourceProject": "string",
  • "destinationProject": "string",
  • "destination": {
    • "type": "assets"
    },
  • "conflictMode": "abort",
  • "query": "string",
  • "createdTime": 0,
  • "startedTime": 0,
  • "finishedTime": 0,
  • "lastSeenTime": 0,
  • "error": "string",
  • "ignoreNullFields": true,
  • "status": "Completed"
}
➔ Next to Update transformations