Trello Developer

Trello Developer

    Rate this page:

    CustomFields

    Create a new Custom Field on a Board

    POST /1/customFields

    Create a new Custom Field on a board.

    Request

    Query parameters
    key Required

    string

    The API key to use

    Pattern: ^[0-9a-fA-F]{32}$
    token Required

    string

    The API token to use

    Pattern: ^[0-9a-fA-F]{64}$
    Body parameters
    idModel Required

    string

    Pattern: ^[0-9a-fA-F]{32}$
    modelType Required

    string

    The type of model that the Custom Field is being defined on. This should always be board.

    Valid values: board

    name Required

    string

    The name of the Custom Field

    type Required

    string

    The type of Custom Field to create.

    Valid values: checkbox, list, number, text, date

    options

    string

    If the type is checkbox

    pos Required

    oneOf [string, number]

    display_cardFront

    boolean

    Whether this Custom Field should be shown on the front of Cards

    Default: true

    Example

    1
2
3
    curl --request POST \
  --url 'https://api.trello.com/1/customFields?key=0471642aefef5fa1fa76530ce1ba4c85&token=9eb76d9a9d02b8dd40c2f3e5df18556c831d4d1fadbe2c45f8310e6c93b5c548' \
  --header 'Accept: application/json'

    Responses

    Success

    Content typeValue
    application/json

    CustomField

    Get a Custom Field

    GET /1/customFields/{id}

    Request

    Path parameters
    id Required

    string

    ID of the Custom Field.

    Pattern: ^[0-9a-fA-F]{32}$
    Query parameters
    key Required

    string

    The API key to use

    Pattern: ^[0-9a-fA-F]{32}$
    token Required

    string

    The API token to use

    Pattern: ^[0-9a-fA-F]{64}$

    Example

    1
2
3
    curl --request GET \
  --url 'https://api.trello.com/1/customFields/{id}' \
  --header 'Accept: application/json'

    Responses

    Success

    Content typeValue
    application/json

    CustomField

    Update a Custom Field definition

    PUT /1/customFields/{id}

    Update a Custom Field definition.

    Request

    Path parameters
    id Required

    string

    ID of the Custom Field.

    Pattern: ^[0-9a-fA-F]{32}$
    Query parameters
    key Required

    string

    The API key to use

    Pattern: ^[0-9a-fA-F]{32}$
    token Required

    string

    The API token to use

    Pattern: ^[0-9a-fA-F]{64}$
    Body parameters
    name

    string

    The name of the Custom Field

    pos

    oneOf [string, number]

    display/cardFront

    boolean

    Whether to display this custom field on the front of cards

    Example

    1
2
3
    curl --request PUT \
  --url 'https://api.trello.com/1/customFields/{id}' \
  --header 'Accept: application/json'

    Responses

    Success

    Content typeValue
    application/json

    CustomField

    Delete a Custom Field definition

    DELETE /1/customFields/{id}

    Delete a Custom Field from a board.

    Request

    Path parameters
    id Required

    string

    ID of the Custom Field.

    Pattern: ^[0-9a-fA-F]{32}$
    Query parameters
    key Required

    string

    The API key to use

    Pattern: ^[0-9a-fA-F]{32}$
    token Required

    string

    The API token to use

    Pattern: ^[0-9a-fA-F]{64}$

    Example

    1
2
    curl --request DELETE \
  --url 'https://api.trello.com/1/customFields/{id}'

    Responses

    Success

    A schema has not been defined for this response code.

    Get Options of Custom Field drop down

    GET /1/customFields/{id}/options

    Get the options of a drop down Custom Field

    Request

    Path parameters
    id Required

    string

    ID of the customfield.

    Pattern: ^[0-9a-fA-F]{32}$
    Query parameters
    key Required

    string

    The API key to use

    Pattern: ^[0-9a-fA-F]{32}$
    token Required

    string

    The API token to use

    Pattern: ^[0-9a-fA-F]{64}$

    Example

    1
2
    curl --request GET \
  --url 'https://api.trello.com/1/customFields/{id}/options'

    Responses

    Success

    A schema has not been defined for this response code.

    Add Option to Custom Field dropdown

    POST /1/customFields/{id}/options

    Add an option to a dropdown Custom Field

    Request

    Path parameters
    id Required

    string

    ID of the customfield.

    Pattern: ^[0-9a-fA-F]{32}$
    Query parameters
    key Required

    string

    The API key to use

    Pattern: ^[0-9a-fA-F]{32}$
    token Required

    string

    The API token to use

    Pattern: ^[0-9a-fA-F]{64}$

    Example

    1
2
    curl --request POST \
  --url 'https://api.trello.com/1/customFields/{id}/options'

    Responses

    Success

    A schema has not been defined for this response code.

    Get Option of Custom Field dropdown

    GET /1/customFields/{id}/options/{idCustomFieldOption}

    Retrieve a specific, existing Option on a given dropdown-type Custom Field

    Request

    Path parameters
    id Required

    string

    ID of the customfielditem.

    Pattern: ^[0-9a-fA-F]{32}$
    idCustomFieldOption Required

    string

    ID of the customfieldoption to retrieve.

    Pattern: ^[0-9a-fA-F]{32}$
    Query parameters
    key Required

    string

    The API key to use

    Pattern: ^[0-9a-fA-F]{32}$
    token Required

    string

    The API token to use

    Pattern: ^[0-9a-fA-F]{64}$

    Example

    1
2
    curl --request GET \
  --url 'https://api.trello.com/1/customFields/{id}/options/{idCustomFieldOption}'

    Responses

    Success

    A schema has not been defined for this response code.

    Delete Option of Custom Field dropdown

    DELETE /1/customFields/{id}/options/{idCustomFieldOption}

    Delete an option from a Custom Field dropdown.

    Request

    Path parameters
    id Required

    string

    ID of the customfielditem.

    Pattern: ^[0-9a-fA-F]{32}$
    idCustomFieldOption Required

    string

    ID of the customfieldoption to retrieve.

    Pattern: ^[0-9a-fA-F]{32}$
    Query parameters
    key Required

    string

    The API key to use

    Pattern: ^[0-9a-fA-F]{32}$
    token Required

    string

    The API token to use

    Pattern: ^[0-9a-fA-F]{64}$

    Example

    1
2
    curl --request DELETE \
  --url 'https://api.trello.com/1/customFields/{id}/options/{idCustomFieldOption}'

    Responses

    Success

    A schema has not been defined for this response code.

    Rate this page: