# Edit request details

`service_requests.update_details`

Update this request's name, purpose, funding amount, currency, due date, or flexibility notes. Requires the current request and criteria revisions. This updates shared request details but does not calculate matches, edit answers, or submit applications. Reuse idempotency_key only for an identical retry.

[Service requests guide](https://docs.levr.ai/mcp/resources/service_requests.md)

Availability depends on live discovery and your access to the record. Do not infer MCP calls from REST paths.

Operation: write. Required OAuth scopes: mcp.

## Client portal input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "changes": {
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "decision_due_date": {
          "format": "date",
          "type": [
            "string",
            "null"
          ]
        },
        "flexibility_notes": {
          "maxLength": 10000,
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        },
        "purpose": {
          "maxLength": 10000,
          "type": [
            "string",
            "null"
          ]
        },
        "target_amount": {
          "pattern": "^[0-9]{1,12}(?:[.][0-9]{1,2})?$",
          "type": [
            "string",
            "null"
          ]
        },
        "target_currency": {
          "pattern": "^[A-Z]{3}$",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "expected_criteria_revision": {
      "minimum": 0,
      "type": "integer"
    },
    "expected_revision": {
      "minimum": 0,
      "type": "integer"
    },
    "idempotency_key": {
      "format": "uuid",
      "type": "string"
    },
    "organization_slug": {
      "maxLength": 100,
      "minLength": 1,
      "type": "string"
    },
    "provider_slug": {
      "maxLength": 100,
      "minLength": 1,
      "type": "string"
    },
    "service_request_slug": {
      "maxLength": 100,
      "pattern": "^srq_",
      "type": "string"
    }
  },
  "required": [
    "service_request_slug",
    "expected_revision",
    "expected_criteria_revision",
    "idempotency_key",
    "changes",
    "organization_slug",
    "provider_slug"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "oneOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "properties": {
        "ok": {
          "const": true
        }
      },
      "required": [
        "data"
      ]
    },
    {
      "not": {
        "required": [
          "data"
        ]
      },
      "properties": {
        "ok": {
          "const": false
        }
      },
      "required": [
        "error"
      ]
    }
  ],
  "properties": {
    "data": {
      "additionalProperties": false,
      "properties": {
        "criteria_revision": {
          "type": "integer"
        },
        "decision_due_date": {
          "format": "date",
          "type": [
            "string",
            "null"
          ]
        },
        "flexibility_notes": {
          "maxLength": 10000,
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        },
        "purpose": {
          "maxLength": 10000,
          "type": [
            "string",
            "null"
          ]
        },
        "revision": {
          "type": "integer"
        },
        "service_request_slug": {
          "type": "string"
        },
        "target_amount": {
          "pattern": "^[0-9]{1,12}(?:[.][0-9]{1,2})?$",
          "type": [
            "string",
            "null"
          ]
        },
        "target_currency": {
          "pattern": "^[A-Z]{3}$",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "service_request_slug",
        "revision",
        "criteria_revision",
        "name",
        "purpose",
        "target_amount",
        "target_currency",
        "decision_due_date",
        "flexibility_notes"
      ],
      "type": "object"
    },
    "error": {
      "additionalProperties": false,
      "properties": {
        "code": {
          "type": "string"
        },
        "details": {
          "additionalProperties": true,
          "description": "Optional bounded, agent-safe correction or recovery facts.",
          "type": "object"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        }
      },
      "required": [
        "code",
        "message",
        "retryable"
      ],
      "type": "object"
    },
    "meta": {
      "additionalProperties": false,
      "properties": {
        "request_id": {
          "type": "string"
        }
      },
      "required": [
        "request_id"
      ],
      "type": "object"
    },
    "ok": {
      "description": "Whether the tool completed successfully.",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "meta"
  ],
  "type": "object"
}
```

Check the result, then read the affected record to confirm your change.
