---
id: telemetry-log-configure
title: Upsert log configuration
description: Create or update log configuration for an application.
sidebar_label: Upsert log configuration
hide_title: true
hide_table_of_contents: true
api: >-
  eJztV01v4zYQ/SvEIIcW0Npx0aKJAh+CpAVcBNig8aILeI2AkSYydymSS1LpGoL++2KoD0uxnK2Ta0+SJYrz5r3hzHMJKbrECuOFVhDDlUXukWnLCpPSndQZS7R6FFlhOS1ij9oyrhg3RookPJpABNpg/X6RQgweJebo7TaWOovb7xEi8DxzEK/gRmcO1hEYbnmOHi09LUEQCMP9BiJQPEeIoRdokUIELtlgziEuwW8NLRDKY4YWqggsfi2ExRRibwuMniW33GAfNltcE3L8xnMjEeJZFTUAvhZotzsEIc5IYOetUNkw7iOXbi/wjc4YfcMKhykTivlNzazzFnnODPcerRqg6ecNh5C5RI9DG+VkFNsdbcEW18dgO8hUikbq7Zu4ug5b5Kj8kaBgdpAmoZznKnmbiItmk2NhiXfn5+dnZ2dnB+ElWnkuFNo34btqdzkWYBf+3QyqdQQOk8IKvw0H8gG5RXtZ+A3EqzW9tuiMVg4dgfzl9JQu++U+6BkUj6Kg8rS6V9nTz44+Kffz1g+fMfEQgbHUW7yoA0qd3WdWF+a+Jm+EJ1pS5xvW3DdJH+CUQAmt7oW6T/k2xNAK3z+G7PdO094W66qKwAsfmJQ6u+rnTRE6nvexw4OQUqhswo2AF3CHmPOTki7VRY+9+ewidID5SRmu1UV9AOcnZX1TXbSlPz8p29vqolN8flJ29xWM0gG/Q1VRkr9+/Lgv9ZUUdFLRWm1ZVxksLZB5zYR64lJQIZrC01DJhXNCZWzX9d9UGrsTsYIcneMZhpkyqJj2xZj8AXfvDbeW08EUHnP342JsGb2lgTW2/+HYNadt4XTz8o8AaFc2dQY1a6FT0+8nLgscpFYPAiYc6yipmhC/jcl2h/YJ7Z5sQqWBfJXRhBfOFch03UQubxfMiRT/1+vHejVlf6OzP7XNuT+g2bLpzcbqJ5GireUz2gYBpM5c28H/tVplZLxos46F1fOEYGrRFdK76WxK5s2LnEbeLmJeOM9y7pNNsxn7BLTwHa38BKGbNZnm6DearJzRLhDZROgLXg6sWTWVOqMJFmqrtnOFlRDDxnvj4umUGzFRhZRGck/xJ4nOBxPnjiqn5rA/dzoxaKN2Rob+GRZB1Ny0bMNf/yyBkhDqUQfy0bq68GeT08kp7IRctkKShpRqzkMNNw36g3Fo/b4JhmfDt9ydiddb6CZJj9/81EguwvgIDJYN/auBKYwgfu6NSYF1BBvSLF5BWT5whx+srCp6XNsO0iUVjj/IQ1ain80R1nUU/xfc7hx0cwggDNL/juEIi/oChtYrvxLEsb70BSSdS34llOOc6AtAer74lVCONJ0vYOmb4B2YNf2wgtAcWbg//d0Mm5/Z+P++USztXFEDeVqMw+NWrasINshTrJtxveYySdD43td7I5KS6trr7fu7JUTAh43uWWPre9EhtLKsVyz1F1RV1SH19Lvu598BFCyItQ==
sidebar_class_name: post api-method
info_path: docs/api/telemetry
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/telemetry-log-configure'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Upsert log configuration"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/application/{applicationId}/log"}
  context={"endpoint"}
>

</MethodEndpoint>

Create or update log configuration for an application.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"applicationId","schema":{"type":"integer"},"required":true,"description":"The application ID.","example":1},{"in":"query","name":"type","schema":{"type":"string"},"required":false,"description":"Log type used in the log stream pattern.","example":"application"},{"in":"query","name":"scope","schema":{"type":"integer"},"required":false,"description":"Scope ID used in the log stream pattern.","example":1},{"in":"query","name":"deploy","schema":{"type":"string"},"required":false,"description":"Deployment ID used in the log stream pattern.","example":"1"},{"in":"query","name":"instance","schema":{"type":"string"},"required":false,"description":"Instance ID used in the log stream pattern.","example":"i-9998888"},{"in":"query","name":"container","schema":{"type":"string"},"required":false,"description":"Container ID used in the log stream pattern.","example":"container-1"}]}
>

</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"Log configuration.","content":{"application/json":{"schema":{"type":"object","properties":{"log_group_name":{"type":"string"},"log_stream_name_pattern":{"type":"string"},"retention_in_days":{"oneOf":[{"type":"integer"},{"type":"string"}]}},"title":"logConfiguration"},"example":{"log_group_name":"billing.api","log_stream_name_pattern":"type=${type};application=1;scope=${scope};deploy=${deploy};instance=${instance};container=${container}","retention_in_days":"7"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"},"error":{"type":"array","items":{"type":"object","properties":{"instancePath":{"type":"string"},"message":{"type":"string"}}}}},"title":"telemetryError"},"examples":{"missingScope":{"value":{"message":"scope is required"}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"},"error":{"type":"array","items":{"type":"object","properties":{"instancePath":{"type":"string"},"message":{"type":"string"}}}}},"title":"telemetryError"},"examples":{"invalidLogFormat":{"value":{"message":"The log provider is reporting logs in the wrong format","error":[{"instancePath":"/results/1/datetime","message":"must match format \"date-time\""}]}}}}}}}}
>

</StatusCodes>