Request

Response

    Deletes an existing flag. Flags
    DELETE

    flags/{flagId}

    Deletes an existing flag.

    Resource Information

    Method and URI
    DELETE
    https://developer.api.autodesk.com/construction/tradetapp/v2/flags/{flagId}
    Authentication Context
    User context required
    Required OAuth Scopes
    data:write
    Data Format
    JSON

    Request

    Headers

    Authorization*
    string
    Must be Bearer <token>, where <token> is a three-legged access token obtained via an Authorization Code flow.
    general-contractor-company-id
    string
    This header is required only for users who belong to a parent enterprise company in TradeTapp. It specifies the BuildingConnected company ID of the child general contractor company for which the request should be performed. Otherwise, it is impossible to know for which child general contractor company the user intends to perform the request.

    For users who do not belong to a parent enterprise company, this header is not required and should be omitted. If provided for such users, the provided value must match the user’s current general contractor company, otherwise the request will be rejected with a 400 Bad Request error.

    * Required

    Request

    URI Parameters

    flagId
    int
    The unique identifier of the flag.

    Response

    HTTP Status Code Summary

    204
    No Content
    No Content
    400
    Bad Request
    The parameters of the requested operation are invalid.
    401
    Unauthorized
    The provided bearer token is not valid.
    403
    Forbidden
    The user or service represented by the bearer token does not have permission to perform this operation.
    404
    Not Found
    The requested resource could not be found.
    409
    Conflict
    Multiple objects were found when only one was expected.
    429
    Too Many Requests
    Rate limit exceeded; wait some time before retrying. The ‘Retry-After’ header might provide the amount of the time to wait.
    500
    Internal Server Error
    An unknown error occurred on the server.

    Response

    Body Structure (204)

    Response for 204 has no body.

    Example

    No Content

    Request

    curl -v 'https://developer.api.autodesk.com/construction/tradetapp/v2/flags/1234' \
      -X 'DELETE' \
      -H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a'
    

    Response

    204 No Content