Custom Properties

Custom properties allow you to add custom fields to resources in your workspace. Learn more about custom properties here.

List Custom Properties

get

https://api.secoda.cohttps://eapi.secoda.cohttps://aapi.secoda.cohttps://{customer_domain}.secoda.co

/api/v1/resource/all_v2/custom_properties/

Get all custom properties in the workspace.

Authorizations

ApiKeyAuth

Responses

200

OK

application/json

get

/api/v1/resource/all_v2/custom_properties/

HTTPcURLJavaScriptPython

GET /api/v1/resource/all_v2/custom_properties/ HTTP/1.1
Host: api.secoda.co
Accept: */*

200

OK

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "entity_types": [
      "text"
    ],
    "value_type": "text",
    "integration": {
      "name": "text",
      "type": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  }
]

Create Custom Property

post

https://api.secoda.cohttps://eapi.secoda.cohttps://aapi.secoda.cohttps://{customer_domain}.secoda.co

/api/v1/resource/all_v2/custom_properties/

Create a new custom property in the workspace.

Authorizations

ApiKeyAuth

Body

application/json

namestringRequired

entity_typesstring[]OptionalDefault: []

value_typestringRequired

Responses

200

OK

application/json

post

/api/v1/resource/all_v2/custom_properties/

HTTPcURLJavaScriptPython

POST /api/v1/resource/all_v2/custom_properties/ HTTP/1.1
Host: api.secoda.co
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "name": "text",
  "entity_types": [
    "text"
  ],
  "value_type": "text"
}

200

OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "entity_types": [
    "text"
  ],
  "value_type": "text",
  "integration": {
    "name": "text",
    "type": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Get Custom Property

get

https://api.secoda.cohttps://eapi.secoda.cohttps://aapi.secoda.cohttps://{customer_domain}.secoda.co

/api/v1/resource/all_v2/custom_properties/{custom_property_id}/

Get details of a specific custom property.

Authorizations

ApiKeyAuth

Path parameters

custom_property_idstringRequired

Responses

200

OK

application/json

get

/api/v1/resource/all_v2/custom_properties/{custom_property_id}/

HTTPcURLJavaScriptPython

GET /api/v1/resource/all_v2/custom_properties/{custom_property_id}/ HTTP/1.1
Host: api.secoda.co
Accept: */*

200

OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "entity_types": [
    "text"
  ],
  "value_type": "text",
  "integration": {
    "name": "text",
    "type": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Update Custom Property

put

https://api.secoda.cohttps://eapi.secoda.cohttps://aapi.secoda.cohttps://{customer_domain}.secoda.co

/api/v1/resource/all_v2/custom_properties/{custom_property_id}/

Update an existing custom property.

Authorizations

ApiKeyAuth

Path parameters

custom_property_idstringRequired

Body

application/json

namestringRequired

entity_typesstring[]OptionalDefault: []

value_typestringRequired

Responses

200

OK

application/json

put

/api/v1/resource/all_v2/custom_properties/{custom_property_id}/

HTTPcURLJavaScriptPython

PUT /api/v1/resource/all_v2/custom_properties/{custom_property_id}/ HTTP/1.1
Host: api.secoda.co
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "name": "text",
  "entity_types": [
    "text"
  ],
  "value_type": "text"
}

200

OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "entity_types": [
    "text"
  ],
  "value_type": "text",
  "integration": {
    "name": "text",
    "type": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Delete Custom Property

delete

https://api.secoda.cohttps://eapi.secoda.cohttps://aapi.secoda.cohttps://{customer_domain}.secoda.co

/api/v1/resource/all_v2/custom_properties/{custom_property_id}/

Delete a custom property.

Authorizations

ApiKeyAuth

Path parameters

custom_property_idstringRequired

Responses

204

No Content

delete

/api/v1/resource/all_v2/custom_properties/{custom_property_id}/

HTTPcURLJavaScriptPython

DELETE /api/v1/resource/all_v2/custom_properties/{custom_property_id}/ HTTP/1.1
Host: api.secoda.co
Accept: */*

204

No Content

No content

Update Entity Custom Property Value

put

https://api.secoda.cohttps://eapi.secoda.cohttps://aapi.secoda.cohttps://{customer_domain}.secoda.co

/api/v1/resource/all_v2/custom_properties/{custom_property_id}/{entity_id}/

Update the value of a custom property for a specific entity.

Authorizations

ApiKeyAuth

Path parameters

custom_property_idstringRequired

entity_idstringRequired

Body

application/json

valuestringRequired

Responses

200

OK

application/json

put

/api/v1/resource/all_v2/custom_properties/{custom_property_id}/{entity_id}/

HTTPcURLJavaScriptPython

PUT /api/v1/resource/all_v2/custom_properties/{custom_property_id}/{entity_id}/ HTTP/1.1
Host: api.secoda.co
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "value": "text"
}

200

OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "properties2": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

Bulk Update Entity Custom Properties

put

https://api.secoda.cohttps://eapi.secoda.cohttps://aapi.secoda.cohttps://{customer_domain}.secoda.co

/api/v1/resource/all_v2/bulk_update/custom_properties/

Update custom property values for multiple entities in a single request. To bulk delete custom property values, set their values to an empty string ("").

Authorizations

ApiKeyAuth

Body

application/json

entity_idsstring[]Required

Responses

200

OK

application/json

put

/api/v1/resource/all_v2/bulk_update/custom_properties/

HTTPcURLJavaScriptPython

PUT /api/v1/resource/all_v2/bulk_update/custom_properties/ HTTP/1.1
Host: api.secoda.co
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "entity_ids": [
    "text"
  ],
  "properties": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

200

OK

{
  "entities": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "properties2": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}