MCP MeasureMCP Measure

인덱스 관측됨

Gorelo MCP by usefulapi

Read tickets, devices, alerts and invoices; create tickets, add comments, log time in Gorelo.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
86%
이름 품질
79%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (1)

  • LOWTool 'gorelo_list_agent_pending_updates' name length outside 3-30 rangegorelo_list_agent_pending_updates에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~6,595토큰 (도구 정의)
~1.8 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 5.15%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "gorelo": {
      "url": "https://gorelo.usefulapi.io/mcp"
    }
  }
}

원격 엔드포인트

https://gorelo.usefulapi.io/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (31)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢gorelo_list_clients(cursor, page_size, query, status_ids, group_ids, ...)

List the MSP's clients (customers). Good first call to find a client id. API: GET /v1/clients.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "query": {
      "description": "Keyword to match against the client name.",
      "type": "string",
      "maxLength": 200
    },
    "status_ids": {
      "description": "Comma-separated client status ids, for example \"12,15\".",
      "type": "string"
    },
    "group_ids": {
      "description": "Comma-separated client group ids, for example \"12,15\".",
      "type": "string"
    },
    "updated_since": {
      "description": "ISO-8601 timestamp, keep clients updated at or after it.",
      "type": "string"
    },
    "created_since": {
      "description": "ISO-8601 timestamp, keep clients created at or after it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_get_client(client_id)

Get one client by id with its details. API: GET /v1/clients/{clientId}.

입력 스키마

{
  "type": "object",
  "properties": {
    "client_id": {
      "type": "string",
      "minLength": 1,
      "description": "Client id (integer, from gorelo_list_clients)."
    }
  },
  "required": [
    "client_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_client_locations(client_id)

List the locations (sites) of one client. API: GET /v1/clients/{clientId}/locations.

입력 스키마

{
  "type": "object",
  "properties": {
    "client_id": {
      "type": "string",
      "minLength": 1,
      "description": "Client id (integer)."
    }
  },
  "required": [
    "client_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_contacts(cursor, page_size, client_ids, query, status_ids, ...)

List client contacts (end users). API: GET /v1/contacts.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "client_ids": {
      "description": "Comma-separated client ids, for example \"12,15\".",
      "type": "string"
    },
    "query": {
      "description": "Keyword matched against email, first name and last name.",
      "type": "string",
      "maxLength": 200
    },
    "status_ids": {
      "description": "Comma-separated contact status (1 Active, 3 Temporary, 4 Archived) ids, for example \"12,15\".",
      "type": "string"
    },
    "location_ids": {
      "description": "Comma-separated location ids, for example \"12,15\".",
      "type": "string"
    },
    "updated_since": {
      "description": "ISO-8601 timestamp, keep contacts updated at or after it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_get_contact(contact_id)

Get one contact by id. API: GET /v1/contacts/{contactId}.

입력 스키마

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "string",
      "minLength": 1,
      "description": "Contact id (integer, from gorelo_list_contacts)."
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_tickets(cursor, page_size, status_ids, client_ids, priority_ids, ...)

List service tickets, newest activity first, with status, priority, client, assignees and SLA. Use the list_ticket_statuses/types/priorities tools to learn the ids for filters. API: GET /v1/tickets.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "status_ids": {
      "description": "Comma-separated ticket status ids, for example \"12,15\".",
      "type": "string"
    },
    "client_ids": {
      "description": "Comma-separated client ids, for example \"12,15\".",
      "type": "string"
    },
    "priority_ids": {
      "description": "Comma-separated priority ids, for example \"12,15\".",
      "type": "string"
    },
    "type_ids": {
      "description": "Comma-separated ticket type ids, for example \"12,15\".",
      "type": "string"
    },
    "lead_assignee_ids": {
      "description": "Comma-separated technician (lead assignee) ids, for example \"12,15\".",
      "type": "string"
    },
    "contact_ids": {
      "description": "Comma-separated contact ids, for example \"12,15\".",
      "type": "string"
    },
    "tag_ids": {
      "description": "Comma-separated tag ids, for example \"12,15\".",
      "type": "string"
    },
    "group_ids": {
      "description": "Comma-separated technician group ids, for example \"12,15\".",
      "type": "string"
    },
    "device_ids": {
      "description": "Comma-separated agent asset (guid) ids, for example \"12,15\".",
      "type": "string"
    },
    "query": {
      "description": "Keyword matched against the ticket title, number and display number.",
      "type": "string",
      "maxLength": 200
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "updatedOn",
        "createdOn"
      ]
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "created_since": {
      "description": "ISO-8601 timestamp, keep tickets created at or after it.",
      "type": "string"
    },
    "created_before": {
      "description": "ISO-8601 timestamp, keep tickets created before it.",
      "type": "string"
    },
    "updated_since": {
      "description": "ISO-8601 timestamp, keep tickets updated at or after it.",
      "type": "string"
    },
    "closed_since": {
      "description": "ISO-8601 timestamp, keep tickets closed at or after it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_get_ticket(ticket_id)

Get one ticket by id (uuid). API: GET /v1/tickets/{ticketId}.

입력 스키마

{
  "type": "object",
  "properties": {
    "ticket_id": {
      "type": "string",
      "minLength": 1,
      "description": "Ticket id (uuid, from gorelo_list_tickets)."
    }
  },
  "required": [
    "ticket_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_ticket_comments(cursor, page_size, ticket_id, sort_order, conversation_type, ...)

List the comments (public replies, private notes) on a ticket. API: GET /v1/tickets/{ticketId}/comments.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "ticket_id": {
      "type": "string",
      "minLength": 1,
      "description": "Ticket id (uuid)."
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "conversation_type": {
      "description": "Conversation kinds to include: 1 Public, 2 Private, 3 Side Conversation, 4 Approval. Comma-separated, or a single value together with conversation_id.",
      "type": "string"
    },
    "conversation_id": {
      "description": "Filter to one conversation id (from the ticket's conversations).",
      "type": "string"
    }
  },
  "required": [
    "ticket_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_ticket_statuses

List the ticket statuses (id and name) used to filter or update tickets. API: GET /v1/tickets/statuses.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_ticket_types

List the ticket types. API: GET /v1/tickets/types.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_ticket_priorities

List the ticket priorities. API: GET /v1/tickets/priorities.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_agent_assets(cursor, page_size, status_ids, client_ids, query, ...)

List agent (RMM managed device) assets with status, OS and client. API: GET /v1/assets/agents.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "status_ids": {
      "description": "Comma-separated device status (2 Online, 3 Offline, 4 Pending Delete; the API also accepts 1 and 6, see the API docs) ids, for example \"12,15\".",
      "type": "string"
    },
    "client_ids": {
      "description": "Comma-separated client ids, for example \"12,15\".",
      "type": "string"
    },
    "query": {
      "description": "Keyword matched against device name, display name and description.",
      "type": "string",
      "maxLength": 200
    },
    "updated_since": {
      "description": "ISO-8601 timestamp, keep devices updated at or after it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_get_agent_asset(agent_asset_id)

Get one managed device by id (guid). API: GET /v1/assets/agents/{agentAssetId}.

입력 스키마

{
  "type": "object",
  "properties": {
    "agent_asset_id": {
      "type": "string",
      "minLength": 1,
      "description": "Agent asset id (guid, from gorelo_list_agent_assets)."
    }
  },
  "required": [
    "agent_asset_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_get_agent_hardware(agent_asset_id)

Get a managed device's processors, memory and disks. API: GET /v1/assets/agents/{agentAssetId}/hardware.

입력 스키마

{
  "type": "object",
  "properties": {
    "agent_asset_id": {
      "type": "string",
      "minLength": 1,
      "description": "Agent asset id (guid)."
    }
  },
  "required": [
    "agent_asset_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_agent_pending_updates(agent_asset_id)

List the Windows updates pending on a managed device, from its last scan (no new scan starts). API: GET /v1/assets/agents/{agentAssetId}/patches/available.

입력 스키마

{
  "type": "object",
  "properties": {
    "agent_asset_id": {
      "type": "string",
      "minLength": 1,
      "description": "Agent asset id (guid) of a Windows agent."
    }
  },
  "required": [
    "agent_asset_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_custom_assets(cursor, page_size, client_ids, query, updated_since)

List custom (non-agent) assets such as printers, switches and licences. API: GET /v1/assets/custom.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "client_ids": {
      "description": "Comma-separated client ids, for example \"12,15\".",
      "type": "string"
    },
    "query": {
      "description": "Keyword matched against the asset name.",
      "type": "string",
      "maxLength": 200
    },
    "updated_since": {
      "description": "ISO-8601 timestamp, keep assets updated at or after it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_alerts(cursor, page_size, status_ids, type_ids, client_ids, ...)

List alerts (uptime, script, external, ...) newest first. API: GET /v1/alerts.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "status_ids": {
      "description": "Comma-separated alert status (1 New, 2 Dismissed, 3 Ticketed) ids, for example \"12,15\".",
      "type": "string"
    },
    "type_ids": {
      "description": "Comma-separated alert type (1 Uptime, 2 API, 3 Script, 4 External, ...) ids, for example \"12,15\".",
      "type": "string"
    },
    "client_ids": {
      "description": "Comma-separated client ids, for example \"12,15\".",
      "type": "string"
    },
    "agent_asset_ids": {
      "description": "Comma-separated agent asset (guid) ids, for example \"12,15\".",
      "type": "string"
    },
    "created_since": {
      "description": "ISO-8601 timestamp, keep alerts raised at or after it.",
      "type": "string"
    },
    "created_before": {
      "description": "ISO-8601 timestamp, keep alerts raised before it.",
      "type": "string"
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_get_alert(alert_id)

Get one alert by id (guid). API: GET /v1/alerts/{alertId}.

입력 스키마

{
  "type": "object",
  "properties": {
    "alert_id": {
      "type": "string",
      "minLength": 1,
      "description": "Alert id (guid, from gorelo_list_alerts)."
    }
  },
  "required": [
    "alert_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_projects(cursor, page_size, status_ids, client_ids, query, ...)

List projects with status, client and lead. API: GET /v1/projects.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "status_ids": {
      "description": "Comma-separated project status ids, for example \"12,15\".",
      "type": "string"
    },
    "client_ids": {
      "description": "Comma-separated client ids, for example \"12,15\".",
      "type": "string"
    },
    "query": {
      "description": "Keyword matched against the project name.",
      "type": "string",
      "maxLength": 200
    },
    "sort_by": {
      "description": "Sort field, for example updatedOn or createdOn.",
      "type": "string"
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "updated_since": {
      "description": "ISO-8601 timestamp, keep projects updated at or after it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_project_tasks(cursor, page_size, project_id, status_ids, assignee_ids, ...)

List the tasks of one project. API: GET /v1/projects/{projectId}/tasks.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "project_id": {
      "type": "string",
      "minLength": 1,
      "description": "Project id (guid, from gorelo_list_projects)."
    },
    "status_ids": {
      "description": "Comma-separated task status (1 Not started, 2 Working on it, 3 On hold, 4 Done) ids, for example \"12,15\".",
      "type": "string"
    },
    "assignee_ids": {
      "description": "Comma-separated technician ids, for example \"12,15\".",
      "type": "string"
    },
    "incomplete_only": {
      "description": "When true, drop tasks in the Done status.",
      "type": "boolean"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "boardOrder",
        "createdOn",
        "updatedOn"
      ]
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_time_entries(cursor, page_size, client_ids, ticket_ids, task_ids, ...)

List logged time across tickets and tasks. API: GET /v1/time-entries.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "client_ids": {
      "description": "Comma-separated client ids, for example \"12,15\".",
      "type": "string"
    },
    "ticket_ids": {
      "description": "Comma-separated ticket (uuid) ids, for example \"12,15\".",
      "type": "string"
    },
    "task_ids": {
      "description": "Comma-separated task (guid) ids, for example \"12,15\".",
      "type": "string"
    },
    "user_ids": {
      "description": "Comma-separated user ids, for example \"12,15\".",
      "type": "string"
    },
    "invoice_ids": {
      "description": "Comma-separated invoice ids, for example \"12,15\".",
      "type": "string"
    },
    "started_since": {
      "description": "ISO-8601 timestamp, keep entries whose work started at or after it.",
      "type": "string"
    },
    "started_before": {
      "description": "ISO-8601 timestamp, keep entries whose work started before it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_invoices(cursor, page_size, client_ids, status_ids, contract_ids, ...)

List invoices with status, totals and client. API: GET /v1/invoices.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "client_ids": {
      "description": "Comma-separated client ids, for example \"12,15\".",
      "type": "string"
    },
    "status_ids": {
      "description": "Comma-separated invoice status (1 Draft, 2 Submitted, 3 Paid, 4 Void, 5 Approved) ids, for example \"12,15\".",
      "type": "string"
    },
    "contract_ids": {
      "description": "Comma-separated contract ids, for example \"12,15\".",
      "type": "string"
    },
    "query": {
      "description": "Free text matched against invoice number, reference and name.",
      "type": "string"
    },
    "invoice_date_since": {
      "description": "Date (yyyy-mm-dd): invoices dated at or after it.",
      "type": "string"
    },
    "invoice_date_before": {
      "description": "Date (yyyy-mm-dd): invoices dated before it.",
      "type": "string"
    },
    "due_date_before": {
      "description": "Date (yyyy-mm-dd): invoices due before it (find overdue invoices).",
      "type": "string"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "createdOn",
        "updatedOn",
        "date",
        "dueDate",
        "totalAmount"
      ]
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_get_invoice(invoice_id)

Get one invoice with its line items and attachments. API: GET /v1/invoices/{invoiceId}.

입력 스키마

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "minLength": 1,
      "description": "Invoice id (from gorelo_list_invoices)."
    }
  },
  "required": [
    "invoice_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_contracts(cursor, page_size, client_ids, status_ids, query)

List billing contracts with their service lines. API: GET /v1/contracts.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "client_ids": {
      "description": "Comma-separated client ids, for example \"12,15\".",
      "type": "string"
    },
    "status_ids": {
      "description": "Comma-separated contract status ids, for example \"12,15\".",
      "type": "string"
    },
    "query": {
      "description": "Keyword matched against the contract name.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_users(cursor, page_size, status_ids, query, group_ids)

List users (technicians) with role and status; use their ids as assignee ids. API: GET /v1/organization/users.

입력 스키마

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Cursor from DataContext.Pagination.NextCursor of the previous page. Omit for the first page.",
      "type": "string"
    },
    "page_size": {
      "description": "Items per page, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "status_ids": {
      "description": "Comma-separated user status ids, for example \"12,15\".",
      "type": "string"
    },
    "query": {
      "description": "Keyword matched against the user name or email.",
      "type": "string"
    },
    "group_ids": {
      "description": "Comma-separated technician group ids, for example \"12,15\".",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gorelo_list_groups

List technician groups (ids are needed to create a ticket). API: GET /v1/organization/groups.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴gorelo_create_ticket(title, status_id, group_id, type_id, description, ...)

WRITE: create a service ticket. Needs status_id, group_id and type_id (use gorelo_list_ticket_statuses, gorelo_list_groups, gorelo_list_ticket_types). Set send_created_email true only if the contact must get a 'ticket created' email. API: POST /v1/tickets.

입력 스키마

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 250,
      "description": "Ticket title."
    },
    "status_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Initial status id."
    },
    "group_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Technician group id."
    },
    "type_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Ticket type id."
    },
    "description": {
      "description": "Ticket body as HTML. Plain text is wrapped in a paragraph. Send < and > as &lt; and &gt;.",
      "type": "string"
    },
    "client_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "location_id": {
      "description": "Needs client_id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "contact_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "priority_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "source_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "lead_assignee_id": {
      "description": "Technician id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991
      }
    },
    "agent_asset_ids": {
      "description": "Managed device ids (guid) to link.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "send_created_email": {
      "description": "Email the contact that the ticket was created (default false).",
      "type": "boolean"
    }
  },
  "required": [
    "title",
    "status_id",
    "group_id",
    "type_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴gorelo_update_ticket(ticket_id, title, status_id, priority_id, type_id, ...)

WRITE: change fields of a ticket (status, priority, assignee, title, tags). Only the fields you send change. Each change notifies and logs as in the app. Changing the client clears the ticket's contact and assets. API: PATCH /v1/tickets/{ticketId}.

입력 스키마

{
  "type": "object",
  "properties": {
    "ticket_id": {
      "type": "string",
      "minLength": 1,
      "description": "Ticket id (uuid)."
    },
    "title": {
      "type": "string",
      "maxLength": 250
    },
    "status_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "priority_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "type_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "lead_assignee_id": {
      "description": "Technician id. Send 0 to unassign.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "tag_ids": {
      "description": "Replaces the whole tag list; [] clears it.",
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991
      }
    },
    "client_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "contact_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "ticket_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴gorelo_add_ticket_comment(ticket_id, body, visibility)

WRITE: add a comment to a ticket's main thread. A 'public' comment is a reply the client sees and may be emailed to them; a 'private' comment is an internal note. Do not retry after an unclear error: that can post twice. API: POST /v1/tickets/{ticketId}/comments.

입력 스키마

{
  "type": "object",
  "properties": {
    "ticket_id": {
      "type": "string",
      "minLength": 1,
      "description": "Ticket id (uuid)."
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "description": "Comment body as HTML. Send < and > in text as &lt; and &gt;."
    },
    "visibility": {
      "type": "string",
      "enum": [
        "public",
        "private"
      ],
      "description": "public = visible to the client; private = internal note."
    }
  },
  "required": [
    "ticket_id",
    "body",
    "visibility"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴gorelo_update_alert_status(alert_id, status, ticket_id)

WRITE: dismiss an alert, restore it to New, or link it to an open ticket (status 'ticketed' needs ticket_id). The change applies to the alert's whole stack, as in the app. API: PATCH /v1/alerts/{alertId}.

입력 스키마

{
  "type": "object",
  "properties": {
    "alert_id": {
      "type": "string",
      "minLength": 1,
      "description": "Alert id (guid)."
    },
    "status": {
      "type": "string",
      "enum": [
        "new",
        "dismissed",
        "ticketed"
      ]
    },
    "ticket_id": {
      "description": "Open ticket id (uuid). Required when status is ticketed.",
      "type": "string"
    }
  },
  "required": [
    "alert_id",
    "status"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴gorelo_log_time_entry(ticket_id, task_id, actual_hours, started_on, ended_on, ...)

WRITE: log work time against a ticket (or a project task). Give any two of started_on, ended_on and actual_hours (the API derives the third). Billing role, work type and billable status default from the ticket. Do not retry after an unclear error: that can log twice. API: POST /v1/time-entries.

입력 스키마

{
  "type": "object",
  "properties": {
    "ticket_id": {
      "description": "Ticket id (uuid). Send this or task_id.",
      "type": "string"
    },
    "task_id": {
      "description": "Project task id (guid). Send this or ticket_id.",
      "type": "string"
    },
    "actual_hours": {
      "description": "Hours worked, decimal.",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "started_on": {
      "description": "ISO-8601 UTC start of the work.",
      "type": "string"
    },
    "ended_on": {
      "description": "ISO-8601 UTC end of the work.",
      "type": "string"
    },
    "comment": {
      "description": "Note that describes the work.",
      "type": "string"
    },
    "billable_status_id": {
      "description": "1 Billable, 2 No charge, 3 Non-billable.",
      "type": "integer",
      "minimum": 1,
      "maximum": 3
    },
    "user_id": {
      "description": "Technician id the time belongs to.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 31개