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

/resource/all_v2/custom_properties/

Get all custom properties in the workspace.

Authorizations

Responses

200

List of custom properties

application/json

500

Internal server error

get

/resource/all_v2/custom_properties/

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

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

Create Custom Property

post

/resource/all_v2/custom_properties/

Create a new custom property in the workspace.

Authorizations

Body

namestringRequired

value_typestring · enumRequiredPossible values:

Responses

200

Custom property created successfully

application/json

500

Internal server error

post

/resource/all_v2/custom_properties/

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

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

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

Get Custom Property

get

/resource/all_v2/custom_properties/{custom_property_id}

Get details of a specific custom property.

Authorizations

Path parameters

custom_property_idstringRequired

Responses

200

Custom property details

application/json

404

Custom property not found

500

Internal server error

get

/resource/all_v2/custom_properties/{custom_property_id}

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

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

Update Custom Property

put

/resource/all_v2/custom_properties/{custom_property_id}

Update an existing custom property.

Authorizations

Path parameters

custom_property_idstringRequired

Body

namestringRequired

value_typestring · enumRequiredPossible values:

Responses

200

Custom property updated successfully

application/json

404

Custom property not found

500

Internal server error

put

/resource/all_v2/custom_properties/{custom_property_id}

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

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

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

Delete Custom Property

delete

/resource/all_v2/custom_properties/{custom_property_id}

Delete a custom property.

Authorizations

Path parameters

custom_property_idstringRequired

Responses

204

Custom property deleted successfully

No content

404

Custom property not found

500

Internal server error

delete

/resource/all_v2/custom_properties/{custom_property_id}

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

No content

Update Entity Custom Property Value

put

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

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

Authorizations

Path parameters

custom_property_idstringRequired

The ID of the custom property

entity_idstringRequired

The ID of the entity

Body

valuestringRequired

Responses

200

Custom property value updated successfully

No content

400

Invalid value type

404

Custom property or entity not found

500

Internal server error

put

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

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

{
  "value": "text"
}

No content

Bulk Update Entity Custom Properties

put

/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

Body

entity_idsstring[]Required

List of entity IDs to update

Example: ["550e8400-e29b-41d4-a716-446655440000","7c9e6679-7425-40de-944b-e07fc1f90ae7"]

Responses

200

Custom property values updated successfully

No content

400

Invalid value type for one or more properties

403

User does not have permission to update entities

404

One or more entities or custom properties not found

500

Internal server error

put

/resource/all_v2/bulk_update/custom_properties/

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

{
  "entity_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  ],
  "properties": {
    "550e8400-e29b-41d4-a716-446655440000": "value1",
    "My%20Custom%20Property": ""
  }
}

No content

Was this helpful?