Maps and workflows

List and delete the maps and workflows you can access.

These endpoints cover the maps and workflows you have access to — your own, plus anything shared with you. To act across the whole organization regardless of owner, use Organization resources.

Both lists are paginated and support the same filters, so you can page through everything tagged a certain way or matching a search term.

Endpoint

What it does

GET /v3/organization-maps

List maps

DELETE /v3/organization-maps/{mapId}

Delete a map

GET /v3/organization-workflows

List workflows

DELETE /v3/organization-workflows/{workflowId}

Delete a workflow

These endpoints need an OAuth Access Token. See Authorization.

Filtering

search matches the title. tags takes a JSON-encoded array such as ["new","biz"]. privacy is private, shared or public for maps, and private or shared for workflows — workflows are never public.

Sort with order_by and order_direction, and page with page and page_size (default 12).

Deleting

You can only delete what you own, and only when nobody else has it locked — otherwise the request returns 403. Deletions are immediate and cannot be undone.

Endpoints

List maps

get

/v3/organization-maps

Lists the maps you have access to in your organization.

Authorizations

AuthorizationstringRequired

An API Access Token or an OAuth Access Token, sent as Authorization: Bearer <token>.

Query parameters

pageinteger · min: 1OptionalDefault: 1

page_sizeintegerOptionalDefault: 12

order_bystringOptionalExample: title

order_directionstring · enumOptionalPossible values:

searchstringOptional

Free-text search over the title.

Example: sales

privacystring · enumOptionalPossible values:

tagsstringOptional

A JSON-encoded array of tags to filter by.

Example: ["new", "biz"]

Responses

200

The maps.

application/json

400

The request is malformed or a parameter failed validation.

application/json

401

The token is missing, malformed or expired.

application/json

get/v3/organization-maps

GET /v3/organization-maps HTTP/1.1
Host: gcp-us-east1.api.carto.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "meta": {
    "page": {
      "current": 1,
      "pageSize": 1,
      "total": null,
      "totalPages": null
    }
  },
  "links": {
    "prev": null,
    "next": null
  },
  "data": [
    {
      "id": "text",
      "title": null,
      "description": null,
      "thumbnailUrl": "text",
      "tags": [
        "text"
      ],
      "views": 1,
      "userId": "text",
      "privacy": "private",
      "createdAt": "2026-08-09T08:47:04.221Z",
      "updatedAt": "2026-08-09T08:47:04.221Z"
    }
  ]
}

Delete a map

delete

/v3/organization-maps/{mapId}

Authorizations

AuthorizationstringRequired

An API Access Token or an OAuth Access Token, sent as Authorization: Bearer <token>.

Path parameters

mapIdstringRequired

Responses

204

The map was deleted.

No content

401

The token is missing, malformed or expired.

application/json

403

You don't own this map, or it is locked by someone else.

application/json

404

The resource doesn't exist.

application/json

delete/v3/organization-maps/{mapId}

DELETE /v3/organization-maps/{mapId} HTTP/1.1
Host: gcp-us-east1.api.carto.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List workflows

get

/v3/organization-workflows

Lists the workflows you have access to in your organization.

Authorizations

AuthorizationstringRequired

An API Access Token or an OAuth Access Token, sent as Authorization: Bearer <token>.

Query parameters

pageinteger · min: 1OptionalDefault: 1

page_sizeintegerOptionalDefault: 12

order_bystringOptionalExample: title

order_directionstring · enumOptionalPossible values:

searchstringOptional

Free-text search over the title.

Example: sales

privacystring · enumOptionalPossible values:

tagsstringOptional

A JSON-encoded array of tags to filter by.

Example: ["new", "biz"]

Responses

200

The workflows.

application/json

400

The request is malformed or a parameter failed validation.

application/json

401

The token is missing, malformed or expired.

application/json

get/v3/organization-workflows

GET /v3/organization-workflows HTTP/1.1
Host: gcp-us-east1.api.carto.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "meta": {
    "page": {
      "current": 1,
      "pageSize": 1,
      "total": null,
      "totalPages": null
    }
  },
  "links": {
    "prev": null,
    "next": null
  },
  "data": [
    {
      "id": "text",
      "title": null,
      "description": null,
      "thumbnailUrl": "text",
      "tags": [
        "text"
      ],
      "userId": "text",
      "privacy": "private",
      "providerId": "text",
      "connectionId": "text",
      "createdAt": "2026-08-09T08:47:04.221Z",
      "updatedAt": "2026-08-09T08:47:04.221Z"
    }
  ]
}

Delete a workflow

delete

/v3/organization-workflows/{workflowId}

Authorizations

AuthorizationstringRequired

An API Access Token or an OAuth Access Token, sent as Authorization: Bearer <token>.

Path parameters

workflowIdstringRequired

Responses

204

The workflow was deleted.

No content

401

The token is missing, malformed or expired.

application/json

403

You don't own this workflow, or it is locked by someone else.

application/json

404

The resource doesn't exist.

application/json

delete/v3/organization-workflows/{workflowId}

DELETE /v3/organization-workflows/{workflowId} HTTP/1.1
Host: gcp-us-east1.api.carto.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

PreviousConnections NextOrganization resources

Last updated 8 days ago

Was this helpful?