Internal services

Create an internal service

Schedules a working day that does not hang off an order: maintenance, transfer between warehouses, training.

Tool

filmo_internal_services_create

Writeinternal-services:write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_internal_services_create",
    "arguments": {
      "title": "Example",
      "startDate": "2026-09-01T08:00:00Z",
      "endDate": "2026-09-01T08:00:00Z"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "title": "Example",
      "status": "<status>",
      "startDate": "2026-09-01T08:00:00Z",
      "endDate": "2026-09-01T08:00:00Z",
      "projectId": "proj_8f2a1c",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generated from the schema

The MINIMUM duration is fifteen minutes. Returns the created internal service.

Arguments

titlestringRequired

Assignment title.

Limits: min length 1

descriptionstring

Description of what needs to be done.

serviceIdstring

Catalogue service it comes from, if it comes from one.

serviceTypestring

Assignment type. Defaults to "crew".

Available options: crew, fleet, general

startDatestring<date-time>Required

Start in ISO 8601 with offset.

endDatestring<date-time>Required

End in ISO 8601 with offset. At least fifteen minutes after the start.

projectIdstring

Project it is charged to.

assignedStaffIdsstring[]

Assigned staff.

assignedVehicleIdsstring[]

Assigned vehicles.

qtyinteger

How many units of the service.

Limits: min 1

requirementsobject[]

Resources needed to provide it.

Show child attributes

requirements.requiredResourceTypestringRequired

What is needed: personnel or vehicle.

Available options: personnel, vehicle

requirements.qtyintegerRequired

How many are needed.

Limits: min 1

idempotencyKeystring

Idempotency key chosen by the client (a UUID is recommended). Repeating the same key with the same arguments within 24 h returns the stored response without executing again; with different arguments it responds 422. It is the safe way to retry after a network failure.

Limits: min length 1, max length 255

ifMatchstring

Optimistic locking: the meta.etag you got from the detail read of this resource (or "*"). If the resource changed since, the call fails with 412 precondition_failed before writing anything; read it again and retry. Omit it to write unconditionally.

Limits: min length 1

Result

On success the result carries structuredContent with data and meta. These are the attributes of data.

Show the attributes of data

idstring

Unique assignment identifier.

titlestring

Assignment title.

statusstring

Status: active, completed or cancelled.

startDatestring<date-time>

Start in ISO 8601 UTC.

endDatestring<date-time>

End in ISO 8601 UTC.

projectIdstring | null

Associated project; null if not applicable.

createdAtstring<date-time>

Creation date in ISO 8601 UTC.

updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

An error is a result with isError: true and the problem in content[0].text; there is no structuredContent. See Errors.

The same operation by REST

This tool runs POST /api/v1/internal-services.

Internal services
Create an internal service
Schedules a working day that does not hang off an order: maintenance, transfer between warehouses, training.
Guides
Safe writes
An assistant that can write can also write the wrong thing. Decide which tools need a person, retry without duplicating, and know what a write sets in motion.
Guides
Errors
A tool error is a result with isError: true and the problem in the first text block. Branch on its code.

Was this page helpful?

Result

Arguments

Result

The same operation by REST

Related pages

Create an internal service

Safe writes

Errors