--- title: "Update a Service" method: PATCH path: "/services/{id}" tags: ["Services"] --- # Update a Service `PATCH /services/{id}` Update settings on the service. ## Path parameters - `id` string, required ## Request body - Service — You can use the default created service, or create multiple services within the same project to have different default behavior for all your different faxing use cases. - `id` string — ID of the fax service used. - `name` string — A friendly name for the service. Maximum is 60 characters. - `incomingWebhookUrl` string — The URL to which Sinch will post when someone sends a fax to your Sinch number. To accept incoming faxes this must be set and your Sinch phone number must be configured to receive faxes. Note: If a webhook uses basicauth credentials, when the webhook URL is retrieved those credentials are masked. It is not possible to retrieve previously-set credentials through the API. - `webhookContentType` 'multipart/form-data' | 'application/json' — The content type of the webhook. - `defaultForProject` boolean — If set to true this is the service used to create faxes when no serviceId is specified in the API endpoints. - `defaultFrom` string — One of your Sinch numbers connected to this service or any of your verified numbers. - `numberOfRetries` integer — The number of times to retry sending a fax if it fails. Default is 3. Maximum is 5. - `retryDelaySeconds` integer — The number of seconds to wait between retries if the fax is not yet completed. - `imageConversionMethod` 'HALFTONE' | 'MONOCHROME' — Determines how documents are converted to black and white on OUTBOUND faxes only. Image conversion is not done on INBOUND faxes. Defaults to value selected on Fax Service object. - `coverPageId` string, ulid — If a value it will always add that cover page id to outbound faxes - `saveOutboundFaxDocuments` boolean — Save fax documents with Sinch when you send faxes. Fax records are retained for 13 months. Records older than 13 months are deleted. - `saveInboundFaxDocuments` boolean — Save fax documents with Sinch when you receive faxes. Fax records are retained for 13 months. Records older than 13 months are deleted. - `scanIncomingBarcodes` boolean — If set to true, barcodes will be detected on incoming faxes. - `inProgressNotifications` boolean — If set to `true`, you will receive a webhook notification for each page sent on an outbound fax. - `projectId` string — The `Id` of the project associated with the call. - `resolution` 'FINE' | 'SUPERFINE' — The resolution for the fax. If this is set at the service, this applies to all faxes sent using that service. If this is set on the fax, this will override the service setting. - `createdAt` string, date-time — The date and time the service was created. - `updatedAt` string, date-time — The date and time the service was last updated. ## Response `200` The updated service, or an [Error](https://developers.sinch.com/docs/fax/api-reference/status-codes) - Service — You can use the default created service, or create multiple services within the same project to have different default behavior for all your different faxing use cases. - `id` string — ID of the fax service used. - `name` string — A friendly name for the service. Maximum is 60 characters. - `incomingWebhookUrl` string — The URL to which Sinch will post when someone sends a fax to your Sinch number. To accept incoming faxes this must be set and your Sinch phone number must be configured to receive faxes. Note: If a webhook uses basicauth credentials, when the webhook URL is retrieved those credentials are masked. It is not possible to retrieve previously-set credentials through the API. - `webhookContentType` 'multipart/form-data' | 'application/json' — The content type of the webhook. - `defaultForProject` boolean — If set to true this is the service used to create faxes when no serviceId is specified in the API endpoints. - `defaultFrom` string — One of your Sinch numbers connected to this service or any of your verified numbers. - `numberOfRetries` integer — The number of times to retry sending a fax if it fails. Default is 3. Maximum is 5. - `retryDelaySeconds` integer — The number of seconds to wait between retries if the fax is not yet completed. - `imageConversionMethod` 'HALFTONE' | 'MONOCHROME' — Determines how documents are converted to black and white on OUTBOUND faxes only. Image conversion is not done on INBOUND faxes. Defaults to value selected on Fax Service object. - `coverPageId` string, ulid — If a value it will always add that cover page id to outbound faxes - `saveOutboundFaxDocuments` boolean — Save fax documents with Sinch when you send faxes. Fax records are retained for 13 months. Records older than 13 months are deleted. - `saveInboundFaxDocuments` boolean — Save fax documents with Sinch when you receive faxes. Fax records are retained for 13 months. Records older than 13 months are deleted. - `scanIncomingBarcodes` boolean — If set to true, barcodes will be detected on incoming faxes. - `inProgressNotifications` boolean — If set to `true`, you will receive a webhook notification for each page sent on an outbound fax. - `projectId` string — The `Id` of the project associated with the call. - `resolution` 'FINE' | 'SUPERFINE' — The resolution for the fax. If this is set at the service, this applies to all faxes sent using that service. If this is set on the fax, this will override the service setting. - `createdAt` string, date-time — The date and time the service was created. - `updatedAt` string, date-time — The date and time the service was last updated. --- [API](https://skmtc.net/sinch/apis/fax-api.md) · [All operations](https://skmtc.net/sinch/apis/fax-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/fax-api/revisions/ebcbb377ee0f/schema)