---
updatedAt: 2026-04-20T19:26:42.000Z
---

# Delete a Hosted Login link

Removes the specified link from the flow.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Flows",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://{hostname}"
    }
  ],
  "paths": {
    "/config/{app_id}/flows/{flow}/links/{linkId}": {
      "delete": {
        "operationId": "delete-link",
        "summary": "Delete a Hosted Login link",
        "description": "Removes the specified link from the flow.",
        "responses": {
          "204": {
            "description": "No content.\n"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "$ref": "#/paths/~1config~1%7Bapp_id%7D~1flows/get/responses/404/content/application~1json/example"
                },
                "schema": {
                  "$ref": "#/paths/~1config~1%7Bapp_id%7D~1flows/get/responses/404/content/application~1json/schema"
                }
              }
            },
            "description": "Flow not found.\n"
          },
          "409": {
            "content": {
              "application/json": {
                "example": {
                  "$ref": "#/paths/~1config~1%7Bapp_id%7D~1flows~1%7Bflow%7D~1links/post/responses/409/content/application~1json/example"
                },
                "schema": {
                  "type": "object",
                  "description": "Resource currently locked. The link you want to remove is currently assigned to one or more forms. Either remove the link from each form and try again, or include the `force` parameter in your call. The `force` parameter removes the link from the flow and from any forms that reference the link.\n",
                  "required": [
                    "errors"
                  ],
                  "properties": {
                    "errors": {
                      "type": "string",
                      "description": "Indicates the status of the operation.\n"
                    }
                  }
                }
              }
            },
            "description": "The flow is being edited by another user and is currently locked.\n"
          }
        }
      },
      "parameters": [
        {
          "$ref": "#/paths/~1config~1%7Bapp_id%7D~1flows/parameters/0"
        },
        {
          "$ref": "#/paths/~1config~1%7Bapp_id%7D~1flows~1%7Bflow%7D/parameters/1"
        },
        {
          "description": "Name of the Hosted Login link.\n",
          "in": "path",
          "name": "linkId",
          "required": true,
          "schema": {
            "type": "string",
            "example": "linkHelp"
          }
        }
      ]
    }
  },
  "x-readme": {
    "samples-languages": [
      "curl",
      "python",
      "node"
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "externalDocs": {
    "url": "https://techdocs.akamai.com/identity-cloud-config/reference",
    "description": "See documention for Akamai's Identity Cloud: Configuration API\n"
  }
}
```

# Sibling pages

* [View a Hosted Login link](https://techdocs.akamai.com/identity-cloud-config/reference/get-link.md)
* [Modify a Hosted Login link](https://techdocs.akamai.com/identity-cloud-config/reference/put-link.md)