Skip to main content
POST
/
projects
Create a new project
curl --request POST \
  --url https://{organization}.data.credibledata.com/api/v0/projects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "resource": "<string>",
  "name": "<string>",
  "readme": "<string>",
  "location": "<string>",
  "connections": [
    {
      "resource": "<string>",
      "name": "<string>",
      "attributes": {
        "dialectName": "<string>",
        "isPool": true,
        "canPersist": true,
        "canStream": true
      },
      "postgresConnection": {
        "host": "<string>",
        "port": 123,
        "databaseName": "<string>",
        "userName": "<string>",
        "password": "<string>",
        "connectionString": "<string>"
      },
      "bigqueryConnection": {
        "defaultProjectId": "<string>",
        "billingProjectId": "<string>",
        "location": "<string>",
        "serviceAccountKeyJson": "<string>",
        "maximumBytesBilled": "<string>",
        "queryTimeoutMilliseconds": "<string>"
      },
      "snowflakeConnection": {
        "account": "<string>",
        "username": "<string>",
        "password": "<string>",
        "privateKey": "<string>",
        "privateKeyPass": "<string>",
        "warehouse": "<string>",
        "database": "<string>",
        "schema": "<string>",
        "role": "<string>",
        "responseTimeoutMilliseconds": 123
      },
      "trinoConnection": {
        "server": "<string>",
        "port": 123,
        "catalog": "<string>",
        "schema": "<string>",
        "user": "<string>",
        "password": "<string>",
        "peakaKey": "<string>"
      },
      "mysqlConnection": {
        "host": "<string>",
        "port": 123,
        "database": "<string>",
        "user": "<string>",
        "password": "<string>"
      },
      "duckdbConnection": {
        "attachedDatabases": [
          {
            "name": "test_connection, _connection, test_connection_1",
            "attributes": {
              "dialectName": "<string>",
              "isPool": true,
              "canPersist": true,
              "canStream": true
            },
            "bigqueryConnection": {
              "defaultProjectId": "<string>",
              "billingProjectId": "<string>",
              "location": "<string>",
              "serviceAccountKeyJson": "<string>",
              "maximumBytesBilled": "<string>",
              "queryTimeoutMilliseconds": "<string>"
            },
            "snowflakeConnection": {
              "account": "<string>",
              "username": "<string>",
              "password": "<string>",
              "privateKey": "<string>",
              "privateKeyPass": "<string>",
              "warehouse": "<string>",
              "database": "<string>",
              "schema": "<string>",
              "role": "<string>",
              "responseTimeoutMilliseconds": 123
            },
            "postgresConnection": {
              "host": "<string>",
              "port": 123,
              "databaseName": "<string>",
              "userName": "<string>",
              "password": "<string>",
              "connectionString": "<string>"
            }
          }
        ]
      },
      "motherduckConnection": {
        "accessToken": "<string>",
        "database": "<string>"
      }
    }
  ],
  "packages": [
    {
      "resource": "<string>",
      "name": "<string>",
      "description": "<string>",
      "location": "<string>"
    }
  ]
}
'
{
  "resource": "<string>",
  "name": "<string>",
  "readme": "<string>",
  "location": "<string>",
  "connections": [
    {
      "resource": "<string>",
      "name": "<string>",
      "attributes": {
        "dialectName": "<string>",
        "isPool": true,
        "canPersist": true,
        "canStream": true
      },
      "postgresConnection": {
        "host": "<string>",
        "port": 123,
        "databaseName": "<string>",
        "userName": "<string>",
        "password": "<string>",
        "connectionString": "<string>"
      },
      "bigqueryConnection": {
        "defaultProjectId": "<string>",
        "billingProjectId": "<string>",
        "location": "<string>",
        "serviceAccountKeyJson": "<string>",
        "maximumBytesBilled": "<string>",
        "queryTimeoutMilliseconds": "<string>"
      },
      "snowflakeConnection": {
        "account": "<string>",
        "username": "<string>",
        "password": "<string>",
        "privateKey": "<string>",
        "privateKeyPass": "<string>",
        "warehouse": "<string>",
        "database": "<string>",
        "schema": "<string>",
        "role": "<string>",
        "responseTimeoutMilliseconds": 123
      },
      "trinoConnection": {
        "server": "<string>",
        "port": 123,
        "catalog": "<string>",
        "schema": "<string>",
        "user": "<string>",
        "password": "<string>",
        "peakaKey": "<string>"
      },
      "mysqlConnection": {
        "host": "<string>",
        "port": 123,
        "database": "<string>",
        "user": "<string>",
        "password": "<string>"
      },
      "duckdbConnection": {
        "attachedDatabases": [
          {
            "name": "test_connection, _connection, test_connection_1",
            "attributes": {
              "dialectName": "<string>",
              "isPool": true,
              "canPersist": true,
              "canStream": true
            },
            "bigqueryConnection": {
              "defaultProjectId": "<string>",
              "billingProjectId": "<string>",
              "location": "<string>",
              "serviceAccountKeyJson": "<string>",
              "maximumBytesBilled": "<string>",
              "queryTimeoutMilliseconds": "<string>"
            },
            "snowflakeConnection": {
              "account": "<string>",
              "username": "<string>",
              "password": "<string>",
              "privateKey": "<string>",
              "privateKeyPass": "<string>",
              "warehouse": "<string>",
              "database": "<string>",
              "schema": "<string>",
              "role": "<string>",
              "responseTimeoutMilliseconds": 123
            },
            "postgresConnection": {
              "host": "<string>",
              "port": 123,
              "databaseName": "<string>",
              "userName": "<string>",
              "password": "<string>",
              "connectionString": "<string>"
            },
            "gcsConnection": {
              "keyId": "<string>",
              "secret": "<string>"
            },
            "s3Connection": {
              "accessKeyId": "<string>",
              "secretAccessKey": "<string>",
              "region": "us-east-1",
              "endpoint": "<string>",
              "sessionToken": "<string>"
            },
            "azureConnection": {
              "sasUrl": "<string>",
              "tenantId": "<string>",
              "clientId": "<string>",
              "clientSecret": "<string>",
              "accountName": "<string>",
              "fileUrl": "<string>"
            }
          }
        ]
      },
      "motherduckConnection": {
        "accessToken": "<string>",
        "database": "<string>"
      },
      "ducklakeConnection": {
        "storage": {
          "bucketUrl": "<string>",
          "s3Connection": {
            "accessKeyId": "<string>",
            "secretAccessKey": "<string>",
            "region": "us-east-1",
            "endpoint": "<string>",
            "sessionToken": "<string>"
          },
          "gcsConnection": {
            "keyId": "<string>",
            "secret": "<string>"
          }
        },
        "catalog": {
          "postgresConnection": {
            "host": "<string>",
            "port": 123,
            "databaseName": "<string>",
            "userName": "<string>",
            "password": "<string>",
            "connectionString": "<string>"
          }
        }
      }
    }
  ],
  "packages": [
    {
      "resource": "<string>",
      "name": "<string>",
      "description": "<string>",
      "location": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.credibledata.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Represents a Malloy project containing packages, connections, and other resources

​
resource
string

Resource path to the project

​
name
string

Project name

​
readme
string

Project README content

​
location
string

Project location, can be an absolute path or URI (e.g. github, s3, gcs, etc.)

​
connections
object[]

List of database connections configured for this project

​
packages
object[]

List of Malloy packages in this project

Response

Returns the project created

Represents a Malloy project containing packages, connections, and other resources

​
resource
string

Resource path to the project

​
name
string

Project name

​
readme
string

Project README content

​
location
string

Project location, can be an absolute path or URI (e.g. github, s3, gcs, etc.)

​
connections
object[]

List of database connections configured for this project

​
packages
object[]

List of Malloy packages in this project