---
id: log-config-list
title: "List log configurations"
description: "List log configurations for a specific organization and account."
sidebar_label: "List log configurations"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/control-plane
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List log configurations"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/controlplane/log/config"}
  context={"endpoint"}
>
  
</MethodEndpoint>



List log configurations for a specific organization and account.

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

<ParamsDetails
  parameters={[{"in":"query","name":"organization_id","required":true,"schema":{"type":"integer"},"description":"The ID of the organization.","example":1234},{"in":"query","name":"account_id","required":true,"schema":{"type":"integer"},"description":"The ID of the account.","example":2345},{"in":"query","name":"selector","required":false,"schema":{"type":"object"},"description":"An object containing key-value pairs representing tags to be matched for applying the log configuration. For example: `{ \"environment\": \"production\", \"service\": \"api\" }`.\n","example":{"environment":"production","service":"api"}}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"A list of log configurations.","content":{"application/json":{"schema":{"type":"object","required":["paging","results"],"properties":{"paging":{"type":"object","required":["offset","limit"],"properties":{"offset":{"type":"integer","minimum":0,"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},"limit":{"type":"integer","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"results":{"type":"array","items":{"type":"object","properties":{"is_default":{"type":"boolean","description":"Defines whether this log configuration is the default. \n>\n> **Note**: If true, it requires the `agent:log_config:create-default` permission; otherwise, it requires `agent:log_config:create`.\n>","enum":[true,false]},"expires_at":{"type":"string","description":"If the log configuration is not default, an expiration date must be specified.","example":"2024-07-12T15:00:00Z"},"account_id":{"type":"integer","description":"Applicable if the log specification is at the account level.","example":2345},"selector":{"type":"object","description":"The tags to be matched to apply the log configuration.","example":{"environment":"production"}},"configuration":{"type":"object","description":"The log configuration as defined in the log specification.","example":{"log_level":"debug","no_error_sampling":50}},"created_configuration_defaults":{"type":"array","items":{"type":"object","properties":{"template_id":{"type":"string"},"template_name":{"type":"string"},"capability_category":{"type":"string"},"capability_provider":{"type":"string"},"default_configuration_id":{"type":"string"}},"title":"configurationDefault"}}},"title":"logConfig"}}},"title":"logConfigListResponse"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>