Skip to main content
Creates a new source

Authorizations

Authorization
string
header
required

HTTP Basic authentication using global administrator credentials (username and password).

Headers

X-Workspace-Id
string

Scopes this request to the given workspace. Takes priority over the workspaceId query parameter. When omitted, falls back to account scope.

Query Parameters

suppressWarnings
boolean
default:false

The response to this API endpoint may return a validation error with a list of problems. Each problem has a level (ERROR, WARNING). Passing suppressWarnings=true will suppress all warnings and the request will succeed if there are no errors

Body

application/vnd.composer.v3+json
name
string
required

User visible representation of the source. It must be unique within the account

Maximum string length: 255
Example:

"Source Name"

entities
object[]
required

List of entities which is used in creating a source

Minimum array length: 1
joinsInfo
object[]

List of joins which is used in creating a source

folderId
string

Optional folder ID for organizing the source within a project.

Example:

1111

Response

The source was created

name
string
required

Source name. It must be unique within the account

Maximum string length: 255
Example:

"Source Name"

id
string
read-only

Unique identifier of the source

Example:

"59ba04795b542f60838ce0ea"

description
string
Maximum string length: 1500
auditable
object
read-only

Contains information about users and time of creating and updating this object

storage
object

Describes how and from where we get data

tags
string[]

Tags. Note: Tags are not supported as a sort parameter in the pagination API.

originId
string
read-only

Id of the exported source

scope
enum<string>
read-only

Scope of the source: ACCOUNT (visible account-wide) or WORKSPACE (visible only inside the owning workspace). Derived from the caller's active workspace at creation time and cannot be set directly.

Available options:
ACCOUNT,
WORKSPACE
workspaceId
string
read-only

Id of the workspace this source belongs to, when scope is WORKSPACE. This field is read-only.

projectId
string
read-only

Project ID where this source is organized. This field is read-only.

Example:

2222

folderId
string

Optional folder ID for organizing the source within a project.

Example:

1111

positionConfiguration
object

Defines position configuration of collections in canvas